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MICRO is a publication devoted to the world of 
the 6502 microprocessor: the 6502 based micro- 
computers, peripheral hardware, software, ideas, 
applications and so forth. 

MICRO began publication with the Oct/Nov 1977 
issue and was published regularly on a bi- 
monthly basis for the first year. This volume, 
"The BEST of MICRO - Volume 1", contains all of 
the significant material from the first year of 
MICRO.- Only the advertising, a few minor arti- 
cles, and a few dated articles have been omit- 
ted. Any errors which were discovered after the 
initial publication of the articles have been 
corrected in this collection. 

MICRO obtains most of its material from it's 
readers: users of 6502 based systems - hobbyists 
and professionals alike. Authors are paid a 
modest fee for articles which appear in MICRO, 
and will obtain additional royalities for re- 
printing such as this collection. 

MICRO is interested in promoting the use of the 
6502 and feels that this can best be accomplish- 
ed by presenting material that is of a useful, 
informative nature as opposed to lots of qames 
or vague "think" pieces. 

MICRO has, in its first year which is covered in 
this volume, focused primarily on the KIM, PET, 
and APPLE microcomputers. This is because the 
material we received was about these three sys- 
tems. We would welcome material about the OSI 
systems, or any of the myriad of other 6502 

^$ftS0QmSr$W& Ve alao 



terns that" ar~e^fe^^^^^iTab?e" afthe^nd 
of the first yeft2UEeV'3^^<sHd-4he AIM 65. 

MICRO covers all of the 6502 based systems be- 
cause we feel that ideas generated on one system 
may often be useful to users of other related 
systems. Therefore, do not just read the stuff 
in the section on your particular machine, but 
find out about the other machines as well, and 
see what you can adapt to your own uses. 

MICRO is now published monthly by MICRO Ink, Inc. 
For information on subscriptions and back issues, 
write to: 

MICRO 

P.O. Box 64 

So. Chelmsford, MA 01824 

USA 



Editor/Publisher 
Robert M. Tripp 
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KIM-1 



Commodore Business Machines, Inc. 

901 California Avenue 

Palo Alto, CA 94304 

415/326-4000 



Improving the KIM-1 Keyboard 7 

by MOS Technology - A hardware modification for your KIM-1 

Hypertape and Ultratape g 

by Robert M. Tripp, Editor of MICRO, author of PLEASE and 
other software and hardware for the KIM-1 

A Block Hex Dump and Character Map Utility Program 12 

for the KIM-1 

by 3. C. Williams 

Important Addresses of KIM-1 and Monitor* 16A 

(two reference cards) 
by William Dial - A Programmer's Reference Card for the KIM-1 

A Debugging Aid for the KIM-1 17 

by Albert Gaspar 

Employing the KIM-1 Microcomputer as a Timer and Data 21 

Logging Module 

by Marvin L. DeJong 

A Simple Frequency Counter Using the KIM-1 26 

by Charles R. Husbands 

Digital-Analog and Analog-Digital Conversion Using the KIM-1 30 
by Marvin L. DeJong - Experiments with a KIM-1 controlled 
DAC/ADC 

Making Music with the KIM-1 34 

by Armand L. Camus - How to write music for a DAC, with 
the complete score for "Deck the Halls with Boughs of Holly" 

A Complete Morse Code Send/Receive Program for the KIM-1 38 
by Marvin L. DeJong 



* two perforated "tear-out" reference cards 



IMPROVIIG KIM-1 KEYBOARD RELIABILITY 

KIM Application Note 

M05 Technology 
950 Rittenhouse Road 
Norristown, PA 19401 



The keyboard on some KIM-1' s has a 
"bouncy" key problem and the "9", "D" , 
or "C" keys may fail entirely. The 
problem is due to the use of the outer 
edge of the snap-action discs to jump 
over the center contact line on the 
keyboard pc. Since the discs are only 
held against the pc board with tape , 
the contact is poor. There are five of 
these jump-overs in series for the "C" 
key (four for the "9" key), thereby 
compounding the problem. To check for 
the problem, measure the resistance 
from keyboard pin 3 to pin 15 (numbered 
from left to right as shown) with the 
"C" key depressed . It should be less 
than about 10 ohms. 

Fortunately, this problem can be easily 
corrected. The solution is to solder a 
thin wire jumper across these poor con- 
tacts as follows. Disassemble the key- 
board bv first removing the four screws 
on the back of the keyboard at the cor- 
ners. Then remove the two remaining 
screws that hold the keyboard to the 
KIM-1 (note for reassembly that they 
are longer) , being careful not to pull 
the keyboard pc board away from the 
KIM-1 board — it's only attached by the 
solder at one end. With the KIM-1 up- 
side down, separate the black keyboard 
panel from the keyboard pc board. You 
may wish to cover the keyboard with 
masking tape to hold the keys in place . 
After cutting four small holes through 



the clear Mylar at the locations indic- 
ated by an X in the figure, the lines 
from the "C" to "9", "D" to "9", "A" to 
"7" and the line to "B" are exposed. 
Connecting these points by soldering a 
thin wire between them routed as shown 
is sufficient to bridge the five poten- 
tially poor contacts. 
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HYPERTAPE AND ULTRATAPE 

Robert M. Tripp 

P. 0. Box 3 

So. Chelsford, MA 01824 



While the cassette tape I/O of the KIM-1 is one 
of its best features, it is terribly slow. 
Waiting a couple of minutes to load a 1K program 
can be a real pain. Jim Butterfield showed how 
to speed up the tape process by writing KIM com- 
patible tapes which were up to six times as fast 
as the normal KIM ( "duper tapes " , mm- i user 
Notes, Vol. 1, Issue 2, Page 12, or "Hypertape" , 
The First Book of KIM, Page 119). For the COMP- 
UTERIST HELP packages— Editor , Mailing List, and 
Information Retrieval — I doubled this rate by 
writing a byte of data as a byte, not converting 
it into two ASCII characters. This "Ultratape" 
is not KIM compatible and requires a special 
loading program. The DUMP routine presented 
here combines both Hypertape and Ultratape. The 
LOAD routine is used to load an Ultratape. 
These two routines , as presented here , assume 
that your system has a means of turning the cas- 
sette tape units on and off under program con- 
trol . (See "Computer Controlled Relays", 
Page 122). 

Dumping Hypertape 

Eight locations in page zero are used to hold 
the arguments for DUMP. For Hypertape they are: 

00D8 Select Hypertape Mode 02 

00D9 Program Identification No. (ID) 01 -FE 

00 DA Starting Address Low (SAL) 

00DB Starting Address High (SAH) 

00DC Low Memory Address of Data 

00 DD High Memory Address of Data 

00DE Low Count of Bytes to Dump 

00DF High Count of Bytes to Dump 

A feature of this version of Hypertape is that 
the data to be dumped does not have to reside 
in its normal memory locations. The Starting 
Address stored on the tape is provided by 
00DA and 00DB independently from the actual mem- 
ory address which is provided by 00DC and 00DD. 

Four additional locations are used on page zero 
to control the rate at which the data is dumped. 

00E8 3700 Hz Speed Control 02 = 6X 

(04 = 3X, 06 = 2X, 0C = 1X) 
00E9 3700 Hz Pulse Duration = C3 
00EA 2400 Hz Speed Control 03 = 6X 

(06 = 3X, 09 = 2X, 12 = 1X) 
00 EB 2400 Hz Pulse Duration = 7E 



Locations 00EC and 00ED are used for temporary 
storage. Note that you must change the values 
of both 00E8 and 00EA to change the dump speed 
to three, two, or one times the normal KIM dump 
rate. 

DUMP starts at location 0120. The first inst- 
ruction is a subroutine call to turn on the cas- 
sette unit via a relay. If your system is not 
equiped for automatic control of the cassette , 
then simply put NOP's in place of this instruc- 
tion (EA, EA, EA) and the matching subroutine 
call at location 01A0. The two NOP's at 0123 
replace an instruction that was used in the HELP 
version but which is not required generally. 
Location 01 A6 is the end of the DUMP. This may 
be either a JMP instruction (as shown) or can be 
an RTS instruction if DUMP is called as a sub- 
routine . 



Hypertape Format 

Hypertape uses the standard KIM cassette tape 
format . 

100 SYNCs/Start of Header/ID/SAL/SAH/2 ASCII 
characters for each byte of data .. ./Term- 
inator /Cim,/ CHKH/ EOT/ EOT 

SYNC is the ASCII SYNC character = 16 hex. 
Start of Header is the ASCII » = 2A hex. 
ID is the Program Identification Number = 01 to 
FE hex. 

SAL and SAH are the Start Address Low and Start 
Address High which are used by the KIM Loader. 
Each byte of data is converted into two ASCII 
characters such that a 3F would be stored as 
ASCII 3 (33) and ASCII F (46). 

The Terminator is an ASCII / = 2F hex. CHKL 
and CHKH are the Check Digit Low and Check Digit 
High which are generated by the KIM CHKT sub- 
routine during the DUMP and are tested during 
the LOAD routine. 
EOT is the ASCII character = 04 hex. 

Loading Hypertape 

Since Hypertape is KIM compatible, all you need 
to load it is the standard KIM Monitor load rou- 
tine. Set your arguments in 17F5 through 17F9, 
make sure that the status bits in 00F1 are zero, 
and start the loader at 1873. That's all there 
is to it . 



Dumping Ultratape 

The same eight page zero locations that were 
used to hold the arguments for the Hypertape 
DUMP are used for the Ultratape DUMP, but 00 DA 
and 00DB have a different usage. 

00D8 Select Ultratape Mode 01 

00D9 Program Identification Number 01 -FE 
00 DA Low Count of Bytes Dumped 
00DB High Count of Bytes Dumped 
00 DC Low Memory Address of Data 
00DD High Memory Address of Data 
00DE Low Count of Bytes to Dump 
00DF High Count of Bytes to Dump 

The Ultratape Routine produces a tape that is 
not compatible with the KIM Monitor. The basic 
difference is that it stores a byte of data dir- 
ectly without converting it into two ASCII char- 
acters . This results in a two-to-one data com- 
pression over the KIM method . Since any date 
value is valid, there must be some way to deter- 
mine how much data there is in a record . The 
Terminator character (/=2F) cannot be used since 
there is no way to distinguish between it and a 
2F hex data byte . The problem is solved by put- 
ting a count of the number of data bytes into 
the Header of the tape record. Since the LOAD 
routine will provide the Starting Address infor- 
mation , the SAL and SAH bytes are not needed . 
Ultratape uses these two positions in the header 
to store a two byte count which will be used by 
LOAD to know how many bytes of data to load. 
Because the LOAD routine uses a portion of the 
KIM Monitor to get into sync , to test the Pro- 
gram ID, and to pick up the header information 
(two byte counter) , and does not regain control 
until after the first byte of data has been 
picked up and packed by the KIM, the first data 
byte of Ultratape is actually stored as two 
ASCII characters, just as in Hypertape. All 
other data bytes are stored without conversion . 
A Terminator character follows the last valid 
data byte so that LOAD can test it and make sure 
it has not missed or added a character. The 
remainder of the Header and Trailer are ident- 
ical to the KIM standard . 

100 SYNCs / Start of Header / ID / Count Low/ 
Count High / 2 ASCII characters for the first 
data byte / one byte for each data byte.../ 
terminator / CHKL / CHKH / EOT / EOT 



Loading Ultratape 

Since Ultratape is not KIM compatilbe , it re- 
quires a special LOAD routine . The LOAD routine 
uses four locations in page zero to hold its 
arguments : 

00D8 Select Load Function 00 

00D9 Program Identification Number 01 -FE 
00DA Starting Address Low 
00DB Starting Address High 
(00DC is used internally by LOAD) 

Locations 0OE8 to 00EB which were required to 
set the speed in the dump routines are not req- 
uired for LOAD. LOAD starts at 0200 with a sub- 
routine call to the routine to turn on the cas- 
sette under program control . This should be 
NOP'ed if you do not have your cassettes under 
program control. Similarly the call at location 
024C should be NOP'ed. Since it is possible to 
get and detect an error during a LOAD, there 
must be some way to signal this back to the cal- 
ling routine. In the HELP programs which this 
code comes from, a location called STEPNO is in- 
cremented on good loads and not incremented on 
bad loads via the instruction at location 024A.. 
To make LOAD a more general subroutine you can 
change this to increment location 00D8 which 
should be set to zero before calling LOAD. Then 
upon return from LOAD this location can be test- 
ed and some action taken if an error has occurr- 
ed. Location 024F is the end of LOAD. It may 
be either a JMP instruction (as shown) or can be 
an RTS instruction if LOAD is called as a sub- 
routine . 

In addition to being faster than loading via the 
KIM monitor , LOAD has the feature that when the 
load is complete control returns to the user 
program, not the KIM Monitor. This makes it 
possible to load data from the cassette under 
program control without ending up in the KIM 
Monitor with location 0000 staring you in the 
face . The data loaded may be ASCII data as in 
the HELP programs, or may be program data that 
is overlaying part of the RAM under program con- 
trol. This feature considerably expands the 
^he usefulness of the KIM cassette interface . 

Cassette On/Off Routines 

TWRITE at 0252 toggles the direction bit for 
PB1. This turns a relay on and off on success- 
ive calls. DUMP calls TWRITE to control the 
WRITE cassette. TREAD at 0256 toggles the dir- 
ection bit for PB0 to control the action of a 
second relay. TREAD is called by LOAD to con- 
trol the READ cassette unit . 
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BLOCK HEX DUMP AND CHARACTER MAP 
UTILITY PROGRAM FOR THE KIM-1 

3. C. Williams 
35 Greenbrook Drive 
Cranbury, NJ 08512 



Here's a useful, fully relocatable 
utility program which will dump a spec- 
ified block of memory from a KIM to a 
terminal. At the user's option, a hex 
dump with an ASCII character map is 
produced. 

The hex dump will allow the programmer 
to rapidly check memory contents 
against a "master" listing when loading 
or debugging programs. With a printing 
terminal, the hex dump produces docu- 
mentation of machine code to complement 
an assembly listing of a program. 

A character map is useful if the block 
being dumped is an ASCII file. An 
example would be source code being pre- 
pared with an editor for later assem- 
bly. The map shows what the file is 
and where it is in case a minor correc- 
tion is needed using the KIM monitor . 

To use this utility program: 

1 . Load the code anywhere you want it , 
in RAM or PROM memory. 

2. Define the block to be dumped just 
as for a KIM-1 tape dump: 

BLOCK STARTING ADDRESS 17F5 (low) 

17F6 (high) 

BLOCK ENDING ADDRESS+1 17F7 (low) 

17F8 (high) 

3. Select the MAP/NOMAP option: 



MAP mode 
NOMAP mode 



00 in 17F9 
FF in 17F9 



monitor. The examples following the 
assembly listing will give you the 
idea. 

The program as listed dumps 16 decimal 
bytes per line. Users with TVT's may 
want to initialize the line byte count- 
er for 8 decimal bytes per line to al- 
low the hex with MAP format to fit the 
display. To make this change, replace 
the $0F at $02 1E with $07- 

Another possible change is to have the 
program exit to a location other than 
the KIM-1 monitor. Exit to a text ed- 
itor or tape dump may be convenient . 
Since the MAP/NOMAP option is deter- 
mined by the most significant (sign) 
bit of what is stored at $17F9, a suit- 
able tape ID number can be placed there 
for use of the KIM-1 tape dump or 
Hypertape. Use ID's from $01-$7F for 
files needing no character map and ID'S 
from $80-$FE for ASCII files. Start 
the tape recorder in RECORD when the 
dump to the terminal is a few seconds 
from completion. 

The flowchart will assist users wanting 
to make major alterations. Of neces- 
sity, ASCII non-printable characters 
are mapped as two hex digits. If other 
ASCII codes have special meaning for 
the user's terminal, a patch will be 
necessary to trap them. Single-step- 
ping through this program can't be done 
because it uses the monitor's "display" 
locations. This is a small price to 
pay in order to use the monitor's sub- 
routines. If use with a non-KIM 650X 
system is desired, the subroutines used 
must preserve the X register. 



SYMBOL 


TABLE 














CRLF 


1E2F 


DOMAP 


026E 


DONE 


028A 


EAH 


17F8 


EAL 


17F7 


EXT 


1C4F 


INCPT 


1F63 


INIT 


0200 


LINE 


020D 


LINEA 


0217 


LINEB 


0228 


LNTST 


0279 


MODE 


17F9 


NXLN 


0285 


0UTCH 


1EA0 


OUTSP 


1E9E 


POINTH 


00FB 


POINTL 


00FA 


PRTBYT 


1E3B 


PRTPNT 


1E1E 


PTBT 


0243 


SAH 


17F6 


SAL 


17F5 


SPO 


0262 


TMODE 


00F9 


TSTEND 


0247 
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BLOCK HEX DUMP WITH CHARACTER MAP 



START 



NO 



f DONE 



ICES 



PRINT CRLF 

FIX STACK 

EXIT TO MONITOR 



INITIALIZE POINTER 
PRINT CRLF 



LINE 



I 



SET "NOMAP" TEMPORARY MODE 
PRINT CRLF 



I 



-> ( LINE1 ) 



SAVE POINTER ON STACK 
SET BYTE COUNTER FOR l6 
PRINT 3 SPACES 



( LINE2 J <- 



PRINT i SPACE 

PRINT BYTE @ (POINTL) AS 2 
HEX DIGITS OR i CHARACTER 
AS REQUIRED BY TEMP. MODE 
AND PRINTABILITY 



DECREMENT BYTE COUNTER 




NO 



NO 



SET "MAP" TMODE 
RESET POINTER TO 
LINE START 
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REMOVE SAVED POINTER 
FROM STACK 



0200 



BLOCK HEX DUMP AND CHARACTER MAP 
UTILITY PROGRAM FOR KIM-1 

J. C. WILLIAMS - 1978 

ORG $0200 

MEMORY LOCATIONS 



0200 


TMODE 


* 


$00F9 


0200 


POINTL 


* 


$00FA 


O200 


POINTH 


* 


$00FB 


0200 


SAL 


* 


$17F5 


0200 


SAH 


* 


$17F6 


0200 


EAL 


X 


$17F7 


0200 


EAH 


# 


$17F8 


0200 


MODE 


* 


$17F9 


0200 


EXT 


* 


$1C4F 



TEMPORARY MODE FLAG 
POINTER 

BLOCK STARTING ADDRESS 

BLOCK ENDING ADDRESS + 1 

00 FOR NO MAP, FF FOR HEX AND MAP 
EXIT TO KIM MONITOR 



SUBROUTINES IN KIM MONITOR 



0200 
0200 
0200 
0200 
0200 
0200 

0200 AD F5 17 
0203 85 FA 
0205 AD F6 17 
0208 85 FB 
020A 20 2F 1E 



020D 
020F 
0211 
0214 
0217 
0219 
021A 
021C 
021D 
021F 
0222 
0225 
0228 
022B 
022D 
022F 
0230 
0232 
0234 
0236 
0238 
023A 



A9 00 
85 F9 
20 2F 1E 
20 1E 1E 
A5 FA 
48 

A5 FB 
48 

A2 OF 
20 9E 1E 
20 9E 1E 
20 9E 1E 
20 9E 1E 
AO 00 
B1 FA 
48 

24 F9 
10 OF 

29 7F 
C9 20 

30 09 
68 



OUTCH * 
CRLF * 
OUTSP * 
PRTBYT * 
PRTPNT * 
INCPT * 

INIT LDA 
STA 
LDA 
STA 
JSR 

LINE LDAIM 
STA 
JSR 
JSR 

LINEA LDA 
PHA 
LDA 
PHA 
LDXIM 
JSR 
JSR 
JSR 

LINEB JSR 

LDYIM 

LDAIY 

PHA 

BIT 

BPL 

ANDIM 

CMPIM 

BMI 

PLA 



$1EA0 PRINTS BYTE IN A AS ONE ASCII CHARACTER 

$1E2F CARRIAGE RETURN AND LINE FEED 

$1E9E PRINTS ONE SPACE 

$1E3B PRINTS BYTE IN A AS TWO HEX DIGITS 

$1E1E PRINTS POINTER 

$1F63 INCREMENTS POINTER 

SAL INITIALIZE POINTER 

POINTL 

SAH 

POINTH 

CRLF 

$00 START A LINE 

TMODE INTI TMODE 

CRLF 

PRTPNT PRINT POINTER 

POINTL START A LINE SEGMENT 

POINTH 



$0F 

OUTSP 

OUTSP 

OUTSP 

OUTSP 

$00 



INIT BYTE COUNTER 
OUTPUT SOME SPACES 



GET THE BYTE 



POINTL AND SAME ON STACK 

TMODE IN MAP MODE? 

PTBT NO 

$7F YES. TEST FOR PRINTABLE 

$20 CHARACTER 

PTBT PRINT AS TWO HEX DIGITS 
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023B 20 A0 1E 
023E 20 9E 1E 
0241 10 04 

0243 68 

0244 20 3B 1E 



PTBT 



JSR OUTCH PRINT AS ONE ASCII CHARACTER 

JSR OUTSP AND A SPACE 

BPL TSTEND UNCONDITIONAL BRANCH 

PLA RECOVER BYTE AND 

JSR PRTBYT PRINT AS TWO HEX DIGITS 



0247 
024A 
024C 
024F 
0251 
0254 
0256 
0259 
025B 
025D 
025F 
0260 
0262 
0265 
0268 
026B 
026C 



20 63 1F 
A5 FA 
CD F7 17 
A5 FB 
ED F8 17 
90 23 
2C F9 17 
10 2F 
24 F9 
30 2B 
CA 

30 OC 
20 9E 1E 
20 9E 1E 
20 9E 1E 
CA 
10 F4 



TSTEND JSR 
LDA 
CMP 
LDA 
SBC 
BCC 
BIT 
BPL 
BIT 
BMI 
DEX 
BMI 

SPO JSR 
JSR 
JSR 
DEX 
BPL 



INCPT INCREMENT POINTER 

POINTL AND TEST AGAINST ENDING 

EAL ADDRESS + 1 

POINTH 

EAH 

LNTST 

MODE 

DONE 

TMODE 

DONE 



DOMAP 
OUTSP 
OUTSP 
OUTSP 

SPO 



NOT BLOCK END. TEST FOR LINE END 
END OF BLOCK REACHED. IS MAP 
NEEDED. DONE IF NOT. 
HAS MAP BEEN DONE? 
YES, EXIT 

NO SPACES NEEDED 

SPACE OVER TO CHARACTER MAP 



026E C6 F9 

0270 68 

0271 85 FB 

0273 68 

0274 85 FA 

0276 38 

0277 BO 9E 

0279 CA 
027A 10 AC 
027C 2C F9 17 
027F 10 04 
0281 24 F9 
0283 10 E9 



DOMAP DEC 
PLA 
STA 
PLA 
STA 
SEC 
BCS 



TMODE DO THE MAP. FIRST SET THE 

MAP FLAG AND RESET POINTER TO 
POINTH START OF LINE 

POINTL 

LINEA AND PRINT THE MAP SEGMENT 



LNTST DEX TEST FOR END OF LINE 

BPL LINEB NOT AT END. DO THE NEXT BYTE 

BIT MODE END OF LINE SEGMENT REACHED. 

BPL NXLN NO, DO THE NEXT LINE 

BIT TMODE HAS THE MAP SEGMENT BEEN DONE? 

BPL DOMAP NO, DO IT NOW 



IS MAP NEEDED? 



0285 68 NXLN PLA 

0286 68 PLA 

0287 38 SEC 

0288 BO 83 BCS LINE 

028A 20 2F 1E DONE JSR CRLF 
028D 68 PLA 

028E 68 PLA 

028F 4C 4F 1C JMP EXT 



DO THE NEXT LINE 
FIRST FIXT THE STACK 

DO THE NEXT LINE 

DONE 

REMOVE SAVED POINTER FORM STACK 

EXIT TO KIM MONITOR 
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KIM 


































2880 


52 


17F5 






























17F5 


00 


00. 


BLOCK 


STARTING 


ADDRESS : 


= 2800 












17F6 


28 


28. 






























17F7 


80 


80. 


BLOCK 


ENDING ADDRESS + 


1 = 


2880 










17F8 


28 


28. 






























17F9 


00 


FF. 


SELECT MAP OPTION 


















17FA 


FF 


021E 






























021E 


OF 


07- 


SELECT 8 


LOCATIONS 


PER ] 


LINE 












021F 


20 


0200 






























0200 


AD 


G 


START 


PROGRAM AT 0200 
















2800 




OD 00 


10 


20 


20 


20 


42 


4C 


OD 


00 


10 








B 


L 


2808 




4F 43 


4B 


20 


48 


45 


58 


20 





C 


K 




H 


E 


X 




2810 




44 55 


4D 


50 


20 


41 


4E 


44 


D 


U 


M 


P 




A 


N 


D 


2818 




20 43 


48 


41 


52 


41 


43 


54 




C 


H 


A 


R 


A 


C 


T 


2820 




45 52 


20 


4D 


41 


50 


OD 


00 


E 


R 




M 


A 


P 


OD 


00 


2828 




20 20 


20 


20 


55 


54 


49 


4C 










U 


T 


I 


L 


2830 




49 54 


59 


20 


50 


52 


4F 


47 


I 


T 


Y 




P 


R 





G 


2838 




52 41 


4D 


20 


46 


4F 


52 


20 


R 


A 


M 




F 





R 




2840 




4B 49 


4D 


2D 


31 


OD 


00 


30 


K 


I 


M 


- 


1 


OD 


00 





2848 




OD 00 


40 


20 


20 


20 


4A 


2E 


OD 


00 


§ 








J 


. 


2850 




20 43 


2E 


20 


57 


49 


4C 


4C 




C 


. 




W 


I 


L 


L 


2858 




49 41 


4D 


53 


20 


2D 


20 


31 


I 


A 


M 


S 




- 




1 


2860 




39 37 


38 


OD 


00 


50 


OD 


00 


9 


7 


8 


OD 


00 


P 


OD 


00 


2868 




60 20 


4F 


52 


47 


20 


24 


30 


X 







R 


G 




$ 





2870 




32 30 


30 


OD 


00 


70 


OD 


00 


2 








OD 


00 


P 


OD 


00 


2878 




80 20 


20 


20 


4D 


45 


4D 


4F 


80 








M 


E 


M 






KIM 

17F5 

17F5 00 00. BLOCK STARTING ADDRESS = 2800 

17F6 28 28. 

17F7 80 80. BLOCK ENDING ADDRESS + 1 r 2880 

17F8 28 28. 

17F9 FF 00. SELECT NOMAP OPTION 

17FA FF 021E 

02 1E 07 OF. SELECT 16 LOCATIONS PER LINE 

021F 20 0200 

0200 AD G START PROGRAM AT 0200 

2800 OD 00 10 20 20 20 42 4C 4F 43 4B 20 48 45 58 20 

2810 44 55 4D 50 20 41 4E 44 20 43 48 41 52 41 43 54 

2820 45 52 20 4D 41 50 OD 00 20 20 20 20 55 54 49 4C 

2830 49 54 59 20 50 52 4F 47 52 41 4D 20 46 4F 52 20 

2840 4B 49 4D 2D 31 OD 00 30 OD 00 40 20 20 20 4A 2E 

2850 20 43 2E 20 57 49 4C 4C 49 41 4D 53 20 2D 20 31 

2860 39 37 38 OD 00 50 OD 00 60 20 4F 52 47 20 24 30 

2870 32 30 30 OD 00 70 OD 00 80 20 20 20 4D 45 4D 4F 
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IMPORTANT ADDRESSES OF KIH-1 AND MONITOR 

William R. Dial 

438 Roslyn Avenue 

Akron, DH 44320 



Address 

00EF 
OOFO 
00F1 
00F2 
00F3 
00F4 
00F5 
00F6 
00F7 
00F8 
00F9 
OOFA 
OOFB 
OOFC 
OOFD 
OOFE 
OOFF 



Label 

PCL 

PCH 

P (PREG) 

SP (SPUSER) 

A (ACC) 

Y 

X 

CHKHI 

CHKSUM 

INL 

INH 

POINTL 

POINTH 

TEMP 

TMPX 

CHAR 

MODE 



Function 

Program Counter - Lo Byte 

Program Counter - Hi Byte 

Status Register of Processor 

Stack Pointer 

Accumulator 

Y-Register 

X-Register 

Checksum on Tape, Hi 

Checksum on Tape, Lo 

Input Buffer, Lo - Display Buffer 

Input Buffer, Hi - Display Buffer 

Pointer, Lo - Display 

Pointer, Hi - Display 

Temporary Storage Byte 

Temporary Storage Byte 

Current Character for TTY 

Byte Indicating KYBD or TTY Mode on KIM 



Set "00" for Binary 



Detail of Processor Status Register P (00F1) 



Bit No. 



1 JL 

N V 



3 
D 


2 
I 


1 
Z 




c 
1 

















Flags (1 = set) 
Carry 

Zero Result 

Interrupt Disable 

.Decimal Mode 

Break Command 
Reserved for Expansion 
Overflow 
Negative Result 



01FF 

01FE 

01F8 etc. 



STACK 



Needed to Process Interrupts, save Addresses, etc. 



\ 



J6A 



I/O Ports, Interval Timers, and 6530 RAM Usage 



Address 



Label 



1700 




PAD 


1701 




PADD 


1702 




PBD 


1703 




PBDD 


1704 


/ 1744 


CLKIT 


1705 


1745 


CLK8T 


1706 


1746 


CLK64T 


1707 


1747 


CLK1024T 


1707 


1747 


CLKRDI 


1706 


1746 


CLKRDT 



170C 
170D 
170E 
170F 

1740 
1741 
1742 
1743 

1780 

17E7 
17E8 
17E9 
17EA 
17EB 
17EC 
17F2 
17F3 
17F4 
17F5 
17F6 
17F7 
17F8 
17F9 



174C IT 

174D 8T 

174E 64T 

174F 1024T 



SAD 

PADD (SADD) 

SBD 

PBDD (SBDD) 



CHKL 
CHKH 
SAVX 



VEB 

CNTL 30 

CNTH 30 

TIME 

SAL 

SAH 

EAL 

EAH 

ID 



Function 

Port A Data (user 1/0) 

Port A Data Direction (1 = Output) 

Port B Data (User 1/0) 

Port B Data Direction (0 = Input) 

INTERVAL TIMER 

1704 et seq User 

1744 et seq KIM MONITOR 

Read Time Out Bit 
Read Time 

TIMER USED when IRQ Interrupt at PB7 needed 



Port A Data (KIM MONITOR) 
Port A Data Direction 
Port B Data (KIM MONITOR) 
Port B Data Direction 

Available Memory Block (Program PLEASE, etc.) 

Checksum for Tape Monitor 

Storage Location 



Volatile Execution Block 
TTY Delay 
TTY Delay 

Starting Address - Lo (Audio and Paper Tape) 

- Hi 
Ending Address - Lo 

- Hi 

ID Number (Program No. on Tape) 



17FA/FFFA NMIV (NMIL) Stop Vector (Stop = ICOO) Load 00 

FB/FFFB (NMIH) 1C 

FC/FFFC RSTV (RSTL) RST Vector 00 

FD/FFFD (RSTH) 1C 

FE/FFFE 1RQV (IRQL) IRQ Vector (BRK = ICOO) 00 

FF/FFFF (IRQH) 1C 



16B 



^ 



SUB-ROUTINES 


- 6530-003 


Address 


Label 


1800 


DUMPT 


1873 


LOADT 


1932 


INTVEB 


194C 


CHKT 


195E 


OUTBTC 


196F 


HEXOUT 


197A 


OUTCHT 


199E 


ONE 


19C4 


ZRO 


19EA 


INCVEB 


19F3 


RDBYT 


1A00 


PACKT 


1A24 


RDCHT 



1A41 



1A6B 



RDBIT 



PLLCAL 



SUB-ROUTINES 


- 6530-002 


1C00 


SAVE 


1C22 


RST 


1C2A 


DETCPS 


1C4F 


START 


1CDC 


PCCMD 


1C64 


CLEAR 


1C6A 


READ 


1C77 


TTYKB 



Function 

Dump Memory to Tape 

Load Memory from Tape 

Initiate Volatile Execution Block 

Compute CHKSUM for Tape Load 

Output One Byte 

Convert LSD of A to ASCII and Output to Tape 

Output to Tape One ASCII CHAR (Use Subs ONE & ZRO) 

Output to Tape = 1 (9 pulses 138 u sec each) 

Output to Tape (6 pulses 207 jx sec each) 

Sub to INC VEB + 1, 2 

Sub to read Byte from Tape 

Pack A = ASCII into SAVX as Hex Data 

Get 1 Character from Tape and Return with 
Character in A (Use SAVX + 1 to ASM Char) 

Gets one bit from Tape and returns it in 
sign of A 

Diagnostics: PLL calibrate Output, 166 jk sec 
pulse string 

KIM Entry vis STOP (NMI) or BRK (IRQ) 
Also SST 

KIM Entry via RST (Reset) 

Count Start Bit 

Make TTY/KB Selection 

Display Program Counter by Moving PC to POINT 

Clear Input Buffer INL, INH 

Get Character 

Main Routine for Keyboard and Display 



\- 
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Address 



Label 



1CE7 


LOAD 


1D42 


DUMP 


1E1E 


PRTPNT 


1E2F 


CRLF 


1E3B 


PRTBYT 


1E5A 


GETCH 


1E88 


INITS 


1E9E 


OUTSP 


1EA0 


OUTCH 


1ED4 


DELAY 



1EEB 



1EFE 



DEHALF 



AK 



1F19 


SCAND 


1F1F 


SCANDS (DISPLA) 


1F48 


CONVD 


1F63 


INCPT 


1F6A 


GETKEY 


1F91 


CHK 


1F9D 


GETBYT 


1FAC 


PACK 


1FD5 


TOP 


1FE7 


TABLE 



Function 



Load Paper Tape from TTY 

Dump to TTY from Open Cell Address to LIMHL, 
LIMHH Limit High , H and L 

Sub to Print POINTL, POINTH 

Print String of ASCII Characters from 
TOP + X to TOP 

Print 1 Hex Byte as Two ASCII Characters 

Get 1 Character from TTY, Return from Sub with 
Char in A. X is preserved and Y returned = FF. 

Initialization for SIGMA 

Print One Character CHAR = A. 
X is preserved, Y returned = FF. 
OUTSP Prints One Space . 

This loop simulates DETCPS Section and will 
delay 1 Bit Time. 

Delay half Bit Time - Double right shift of 
Delay Constant for a Div by 2. 

Sub to Determine if Key is depressed or 

Condition of SSW 

(Key not dep or TTY Mode A = 0) 
(Key dep or KB Mode A = not zero) 

Output to 7 Segment Display 

Lights 7 Segment Display 

Convert and Display Hex - Used by SCAND only 

Sub to Increment POINT 

Get Key from Keyboard, Return with A = Key 
value. If A GT. than 15 then illegal or no Key. 

Sub to Compute Check Sum 

Get 2 Hex Characters and Pack into INL, INH. 
X preserved, Y returned = 0. 

Shift Character in A into INL, INH 

Table 

Table Hex to 7 Segment 
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A DEBUGGING AID F8 



THE KIM-1 



Albert Gaspar 
305 Wall Street 
Hebron, CT 06248 



DEBUG is a program designed to assist the user 
in debugging and manipulating programs. It re- 
sides in memory locations 1780 - 17E6 and pro- 
vides a means for inserting breakpoints in a 
user program, moving blocks of bytes throughout 
memory, filling memory with repetitious data, 
and calculating branch values. It uses selected 
KIM monitor subroutines. 

Operating Modes 

DEBUG has three operating modes : 

1 . Keyboard Mode : DEBUG remains in a wait loop 
anticipating keyboard entry which will be recog- 
nized as either data or command characters. 
This mode is initiated either by using the KIM 
monitor to start at location 178E, or by the 
execution of a previously inserted breakpoint in 
a user program. 

2. Execute Mode: DEBUG executes logic to ser- 
vice a user command. This mode is completed in 
microseconds and will not be noticeable by the 
user. 

3. Non-Control Mode: DEBUG relinquishes con- 
trol when the user keys in "RS", or "ST" during 
Keyboard Mode , or uses the CONTINUE Command . 

To start, the user must first load "B5" into 
17FE and "17" into 17FF using the KIM. Then the 
user begins DEBUG by starting at location 178E. 
This puts DEBUG into Keyboard Mode. The user 
then keys in combinations of the 16 data char- 
acters available on the keyboard. Input data is 
displayed in a manner similar to that of the KIM 
- from right to left - except that only the 
left-most five display positions are utilized 
(exceptions are noted below). 

The user must continue to key in characters un- 
til he is satisified that the required data is 
input. Then one of the several Command code 
characters available (B, C, D, E, or F) is keyed 
in. At this point, or at any time previous to 
this, if the input is not correct and the user 
wishes to change the display, he merely contin- 
ues to enter data until the display string is 
correct . When the display concatenation is sat- 
isfactory (either 2 or 4 data characters and 1 
Command character) he keys in "AD". Now DEBUG 
will go into Execute Mode (without echoing the 
entry of "AD") and immediately examines the 
last previous character input . If this char- 
acter is not a legitimate Command character (B, 
C, D, E, or F) , DEBUG becomes confused and will 
transfer to unpredictable memory locations. 
Thus the user is held wholly responsible for the 
validity of his input. He should always check 
that either his keyed-in data is correct before 
hitting "AD", or that his Command was indeed ex- 
ecuted. Note: if a key other than "AD", the 16 
data characters, "RS", or "ST" is depressed, its 
high order 4 bits are stripped and the remaining 
low order 4 bits are displayed and evaluated as 
whatever the combination happens to represent. 

Assuming that the character input immediately 
prior to "AD" is a legitimate Command character, 
DEBUG - still in Execute Mode - will process 
the data which was input prior to the Command 
code (either 2 or 4 characters). Note that_ the 
Command values (B, U, D, E, of F) if found in 



the data field are processed as standard hex 
values . 

BREAK This command allows the user to insert 
a breakpoint anywhere desired in his pro- 
gram. When this point is subsequently reached 
during execution of his program, control will be 
passed to Keyboard Mode of DEBUG and further 
execution of the user program will effectively 
be temporarily discontinued. Also at this time 
the user area will be restored to the original 
configuration existing at the time of the break- 
point insertion. 

Input Sequence : 

Press Keys See on Display 

4 Data Characters ' B "AD" 4 char B1 

The 4 Data Characters define the Breakpoint 
location desired. The BREAK Command saves the 
user byte at the Breakpoint and deposits a BRK 
instruction in place of it. Thus, that user 
area should not be altered by the user while 
DEBUG is in Non-Control Mode and a Breakpoint 
is eminent , or the Breakpoint return will not 
work. More than one Breakpoint can be eminent 
at one time; however since DEBUG will store only 
one byte at a time, multiple simultaneous 
Breakpoints should be applied only at user loca- 
tions containing the same instruction. This way 
it is immaterial which BRK triggers a return to 
DEBUG - the user area will be properly replaced . 

This Command includes 1 of 2 instances where the 
sixth display position is used . If the sixth 
position contains a 1 , the Command has been cor- 
rectly processed. If the position contains any 
other value , it indicates that depression of the 
"AD" key has caused multiple bounces and the 
byte stored by DEBUG within itself is now "00" - 
not the original user byte. Thus DEBUG will 
still function correctly but will not correct- 
ly restore the user position when a Breakpoint 
return is initiated . The user must restore the 
location manually (using KIM) after the return 
has been performed - otherwise "00" will be left 
in tne location . 

CONTINUE This Command causes DEBUG to pass 
execution to a user specified loca- 
tion. It is similar to the passing of control 
through KIM and either method may be used to ex- 
ecute user code. 

Input Sequence : 

Press Keys See on Display 

4 Data Characters C "AD" 4 char CO 

The 4 Data Characters define the address to 
which control is to be passed . The above dis- 
play is only momentary since control is immedi- 
ately passed to a user area (Non-Control Mode) 
The purpose of the Continue Command will usually 
be to execute to a previously inserted Break- 
point. When this occurs, as previously stated, 
control returns to Keyboard Mode, of DEBUG. 
At this point, the leftmost 4 display digits 
will contain the address at which the Breakpoint 
was located. See Overall Notes #1 for a con- 
tinuation warning. 
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MOVE This Command will move a block of up to 

256 bytes to another memory area. It is 

non-destructive (unless, of course, a shift is 
performed) . 



Input Sequence : 
Press Keys 



See on Display 
4 char FO 



4 Data Characters F "AD" 

(F for From) 

4 Data Characters D "AD" 4 char DO 

(D for Destination) 

2 Data Characters E "AD" XX 2 char EO 

(E for Execute) 

The 4 Data Characters above represent the loca- 
tions one less than the locations, respective- 
ly, from which and to which the data is to 
moved. The 2 Data Characters above represent 
the hex value of the number of bytes to be 
moved. If the user desires to move 256 (dec.) 
bytes, he must input "00" in the "E" Command. 
"F" and "D" execution may be input in either 
order - "F" then "D" or "D" then "F". 

MOVE will correctly move blocks of bytes 
from one area of memory to another. However it 
will correctly shift bytes only in an upward 
direction. Attempting downward shifts will re- 
sult in the repeating of as many of the last 
bytes in the original block as there is a dif- 
ference in the block positions. For example - 
shifting a block of say (n) bytes starting at 
0200 to a new area starting at 0202 will cor- 
rectly shift the (n) bytes upward 2 locations. 
Attempting to shift a block of (n) bytes start- 
ing in 0202 to a new area starting in 0200 will 
result in the last 2 bytes of the original 
block to be repeated downward from their orig- 
inal locations continuing to 0200. This may not 
be completely undesireable since - 1) normally 
the user will be interested in expanding an 
area, not in compressing it (for example, to add 
instructions); and, 2) this serves as a useful 
tool to provide filler bytes in memory when 
desired. 

BRANCH This Command assists in calculating 
Branch values. 

Input Sequence : 

1. Enter the necessary 12 bytes of Branch Over- 
lay, either through KIM or by tape overlay. 
(These will, of course, have to be restored to 
the original configuration when through with 
BRANCH) . 

1 . Put DEBUG into Keyboard Mode . 

Press Keys See on Display 

2 char/2 Char. E "AD" 2 char/2 char/D-VALUE 

The first 2 characters are the 2 least signifi- 
cant values of the Branch Address. The next 2 
characters are the 2 least significant values of 
the Branch to Address. The "E" stands for 
Evaluate. The correct Displacement VALUE will 
appear in the 5th and 6th display positions. 
The displacement is calculated assuming that the 
two addresses are in the same page . For page 
overlap, entry will have to be done twice. We 
believe that different users will have different 
preferential methods for doing this, so our own 
method, which is somewhat involved, is not 
described . If both entries are on the same page 
but are separated by a distance greater than the 
standard branch range, the value calculated will 
be incorrect. It is the user's responsibility 
to check for out-of-range values. 



Overall Notes 

1. When a Breakpoint has been executed, DEBUG 
does not store and then restore accumulator 
register, and status values. Thus, the user 
must take care in continuing from a Breakpoint 
it any of these parameters have a subsequent 
bearing in further user program execution. 
(Though this and other omissions are glaring de- 
fects, no apology is made - there was just in- 
sufficient memory available for inclusion of anv 
refinements.) J 

2. When returning from a "BRK" instruction, 
DEBUG pulls the status register information from 
the stack and ignores it. If this DEBUG version 
is used in conjunction with an interrupt system, 
locations 17FE - 17FF must contain the address 
of the user interrupt handler. The beginning of 
the handler must be similar to that shown on 
page 144 of the KIM Programming Manual. The 
logic listed in example 9.7 must be utilized as 
shown. "BNE BRKP" will point to the DEBUG loca- 
tion defined below. If the user handler deter- 
mines that the interrupt was caused by "BRK", 
then the handler must jump to location 17B5. 
DEBUG will then obtain the "BRK" address and 
perform subsequent logic to return the user byte 
to its original configuration and continue on 
into Keyboard Mode. 

3. This version of DEBUG uses page zero loca- 
tions 0000, 0001, 0002, 0003, and 0004, but only 
as scratch areas during Keyboard and Execute 
Modes. The user can use these areas as tempo- 
rary scratch areas when DEBUG is not being ex- 
ecuted . 

4. Due to limited instruction space, DEBUG is 
particularly susceptible to key bounce. The 
user should remain watchful of such occurrences , 
especially during BREAK execution as previously 
described. 

5. My goal here was to fit as much DEBUG power 
into locations 1780 - 17E6 as possible - not to 
write a great breakpoint/move/branch calculate 
routine. (That has already been done by others) 
Thus DEBUG had to be written in relatively con- 
cise and tight code, using data as instructions, 
instructions as data, overlapping instructions, 
using the same code to do different things, 
instruction modification, position instructions 
in prescribed relative locations, use of "write- 
only-memory", etc. I do not approve of this 
type of programming - in fact I strongly recom- 
mend against it. However, in this case I hope 
the goal I had justifies the mess that DEBUG has 
turned out to be. In any event I would like to 
point out that as tight as the code is, it is 
still possible to add other functions here and 
there. For example the version I usually use 
displays the value of the accumulator in display 
locations 5 and 6 when returning back from a 
Breakpoint . At times I also use another version 
which doesn't require the "BRK" instruction at 
all. This is convenient when debugging inter- 
rupt programs since no additional interrupt is 
needed for DEBUG. However, both versions penal- 
ize me in other areas, which makes it all a 
trade-off decision. 

[Editor's Note: Gaspar seems to be suggesting 
a collection of specialized DEBUG programs, 
each customized to provide a particular set of 
capabilities while residing in minimal memory. 
Using his code as a starting point, a "program- 
wise" reader should be able to construct his own 
set of DEBUG aids.] 
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ZERO 




• 


$0000 : 


LOCATION 0000 


ONE 




* 


$0001 




TWO 




• 


$0002 




THREE 


• 


$0003 




FOUR 




• 


$0004 




INH 




• 


$00F9 : 


KIM DISPLAY POINTERS 


POINTL 


• 


$00FA 




POINTH 


• 


$00FB 




RETURN 


• 


$17B5 


INTERNAL ADDRESS 


TBLOFF 


• 


$17D4 


TABLE OFFSET 


JUMPER 


• 


$17DD 


INTERNAL ADDRESS 


INITI 


* 


$1E8C 


KIM INITIALIZE ROUTINE 


SCANDS 


• 


$1F1F 


KIM SCAN DISPLAY ROUTINE 


GETKEY 


• 


$1F6A 


KIM GET KEYBOARD CHARACTER 


1780 B1 


02 




EXEC 


LDAIY 


TWO GET CHAR TO BE MOVED 


1782 91 


00 






STAIY 


ZERO MOVE IT 


1784 88 








DEY 




1785 DO 


F9 






BNE 


EXEC CONTINUE UNTIL DONE 


1787 98 






DANDF TYA 


GET TO OR FROM ADDRESS 


1788 95 


F3 






STAZX $00F3 STORE IT IS SCRATCH 


178A A5 


FB 






LDAZ 


POINTH 


178C 95 


F4 






STAZX $00F4 


178E 20 


8C 


1E 


START JSR 


INITI SET FLAGS AND INIT. 


1791 20 


1F 


1F 




JSR 


SCANDS DISPLAY BUFFER 


1794 DO 


F8 






BNE 


START 


1796 20 


1F 


1F 


KEY 


JSR 


SCANDS NEW CHARACTER INPUT? 


1799 FO 


FB 






BEQ 


KEY NO, CONTINUE TO DISPLAY 


179B 20 


6A 


1F 




JSR 


GETKEY YES, GET THE CHARACTER 


179E A6 04 






LDXZ 


FOUR PICK UP LAST CHAR. INPUT 


17A0 C9 


10 






CMPIM 


[ $10 IS THE NEW CHAR. "AD"? 


17A2 FO 


30 






BEQ 


PROCES YES. PROCESS CURRENT COMMAND 


17A4 85 


04 






STAZ 


FOUR NO. STORE IT 


17A6 A2 


04 






LDXIM $04 AND SHIFT IT INTO THE DISPLAY 


17A8 OA 






SHIFT ASLA 




17A9 26 


F9 






ROL 


INH SHIFT THE DISPLAY LEFT 


17AB 26 


FA 






ROL 


POINTL 


17 AD 26 


FB 






ROL 


POINTH 


17AF CA 








DEX 




17B0 DO 


F6 






BNE 


SHIFT DONE SHIFTING 


17B2 85 


F9 






STA 


INH YES. ADD NEW CHAR TO DISPLAY 


17B4 FO 


D8 






BEQ 


START UNCONDITION RETURN 


17B6 38 








SEC 




17B7 68 








PLA 


IGNORE STATUS 


17B8 68 








PLA 


GET "FROM" ADDRESS 


17B9 E9 


02 






SBCIM 


I $02 SUBTRACT 2 


17BB 85 


FA 






STAZ 


POINTL DISPLAY LOW ORDER 


17BD 68 








PLA 




17BE E9 


00 






SBCIK 


I $00 SUBTRACT CARRY, IF ANY 


17C0 85 


FB 






STAZ 


POINTH DISPLAY HI ORDER 


17C2 A2 


OC 






LDXIN 


[ $0C CHEAT ON RX 


17C4 E6 


F9 




B 


INC 


INH COUNT KEY BOUNCES 


17C6 AO 


00 






LDYIM $00 


17C8 B1 


FA 






LDAIY 


: POINTL GET USER BYTE 


17CA 9D 


DC 


17 




STAX 


$17DC STORE IT 


17CD BD 


DB 


17 




LDAX 


$17DB GET "BRK" 


17D0 91 


FA 






STAI1 


: POINTL STORE IN USER AREA 


17D2 A2 


OD 






LDXIM $0D CHEAT ON RX 


17D4 A4 


FA 




PROCES LDYZ 


POINTL 


17D6 BD D4 


17 




LDAX 


TBLOFF PREPARE TO GO TO COMMAND LOGIC 


17D9 8D DD 


17 




STA 


$17DD ALTER INSTRUCTION 


17DC DO 


FF 






BNE 


JUMPER JMP TO COMMAND LOGIC 


17DE EA 








NOP 


FUTURE EXPANSION 


17DF E6 






TABLE = 


$E6 BRANCH TO "B" 


17E0 06 








s 


$06 BRANCH TO "C" 


17E1 A9 








= 


$A9 BRANCH TO "D" 


17E2 A2 








= 


$A2 BRANCH TO "E" 


17E3 A9 








= 


$A9 BRANCH TO "F" 


17E4 6C 


FA 


00 


C 


JMI 


POINTL 00 OR ADDRESS USED AS "BRK" 
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BRANCH CALCULATION OVERLAY 



ORG $1780 



INH • 
POINTL * 
POINTH « 



$00F9 
$OOFA 
$OOFB 



INITIALIZE SUBTRACT 



1780 38 EXEC SEC 

1781 A5 FA LDAZ POINTL 
1783 69 FD ADCIM $FD CORRECTION CONSTANT 
1785 E5 FB SBCZ POINTH 

1787 85 F9 STAZ INH STORE RESULT IN DISPLAY 

1789 4C 8E 17 JMP $178E JUMP TO START 



1. Load DEBUG, 
into 17FF. 



Examples 
Load "B5" into 17FE and "17" 



2. Start execution at location 178E. 

3. Depressing any of the 16 keyboard characters 
will cause the 5 leftmost display digits to 
shift left and the new character to be inserted 
into the fifth position. 

4. Assume that there is a program in 0200-0250. 
Now, to execute from 0200-0240: 



2 4 B AD 
2 C AD 



Display is 0240 B1 
0200 CO 
0240 XX 



When the user program executes to location 0240, 
it will return to DEBUG which then will replace 
the original byte at 0240 and will return to 
Keyboard Mode . 

5. User wishes to add a 3 byte instruction in 
0241-0243. Thus he must shift his program from 
0241-0250 to 0244-0253. 



2 4 B AD 

0210 FAD 



Display is 0240 B1 
0240 F0 



(Remember that MOVE requires addresses 1 less 
than the actual values.) 

X X 1 E AD Display is XX10 E0 
(10 = 0250 - 0241 + 1) 



This shifts bytes in 0241-0250 to 0244-0253. 
User can now insert his 3 new instructions into 
locations 0241, 0242, and 0243. 

6. User wishes to load NOP into locations 0300- 
03FF. Load "EA" into 03FF using KIM. Return to 
DEBUG . 



3 F AD 

2 F F D AD 

E AD 



Display is 0300 F0 
02FF DO 
XX00 E0 



(Move 256 decimal bytes.) 

7. User wishes to calculate the value required 
for a HERE BCC START where HERE = 0204 and 
START = 0250. 

First, load overlay (12 bytes) and return to 
DEBUG. 



4 5 E AD 



Display is 0450 4A 



Thus the branch value is 4A and the branch in- 
struction will be BCC 4A. 

Remember that if further DEBUG usage is planned, 
the original 12 bytes starting at 1780 have to 
be replaced . 

Program Notes 

1. The instruction listings at 17B4 and 17E4 
are NOT errors and must be placed in memory 
exactly as shown. 

2. Locations 17E7 and 17E8 are used by the KIM 
monitor for tape checksum. However, their usage 
in DEBUG will not interfere with KIM since the 
two programs do not, of course, use them at the 
same time . 
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EMPLOYING THE KIM-1 MICROCOMPUTER 

kS h TIMER AINID DMA LOGGING MODULE 

Marvin L. De Jong 

Dept . of Mathematics-Physics 

The School of the Ozarks 

Point Lookout, MO 65726 



The interval timers on the 6530 on the 
KIM-1 microcomputer provide a conven- 
ient way to measure the time between 
two or more events. Such events might 
include the start and end of a race, 
the exit of a bullet from a gun and its 
arrival at a measured distance along 
its trajectory, the interruption of 
light to a series of phototransistors 
placed along the path of a falling ob- 
ject, an animal arriving at this feed- 
ing station, the arrival of telephone 
calls, etc. Some of these measurements 
will be described in more detail below. 
Each event must produce a negative 
pulse which the microcomputer detects 
and records the time at which the event 
occurred. The time is stored in memory 
and later displayed on the 6-digit KIM 
display. 

Description of the Programs 

The data logging, timer, and display 
programs are listed in Tables 1, 2, and 
3, respectively. The programs must be 
used together for the applications des- 
cribed in this paper, but each might be 
used with other applications, for exam- 
ple pulse generators, frequency count- 
ers, temperature logging, light flash- 
ing, etc. The events to be timed must 
produce either a one-shot pulse (posi- 
tive-zero-positive) whose duration is 
at least 50 microseconds or a zero to 
positive transition which must be reset 
to zero before the next event. These 
signals are applied to pin PAO on the 
KIM applications connector. The pro- 
grams could easily be modified to de- 
tect positive pulses. 

The first pulse starts the timer which 
continues to operate on an interrupt 
basis. The first pulse is not recorded 
by the data logging program since it 
corresponds to t = 0. Successive pul- 
ses cause the data logging program to 
store the six digit time counter in 
memory. The -number of events (not 
counting the first event) N, to be 
timed must be stored in location 0003. 



Remember to convert the number of 
events, N, to base 16 before entering 
it in memory. As the program is writ- 
ten, N must be less than 75. = 4B hex. 

The function of the timer program is to 
load the interval timer, increment the 
six digit time counter, and return to 
the data logging program. At the end 
of each timing period the timer causes 
an interrupt to occur (pin PB7 on the 
application connector must be connected 
to pin 4 on the expansion connector), 
the computer jumps to the timer pro- 
gram, does its thing, and returns to 
the main data logging program to wait 
for events. 

Table 4 lists several timing intervals 
which are possible and the numbers 
which must be loaded into the various 
timers to produce the given interval. 
For example, if one wishes to measure 
time in units of 100 microseconds, then 
49 hex must be stored in the divide-by- 
one counter whose address is 170C. In 
this case, the numbers which appear on 
the display during the display portion 
of the program represent the number of 
100 microsecond intervals between the 
first event and the event whose time is 
being displayed. To put it another 
way, multiply the number on the display 
by 0.0001 to get the time in seconds. 
The other possibilities listed in the 
table are treated in the same way. 

When all N events have been logged, the 
program automatically jumps to the dis- 
play program. When one is ready to re- 
cord the data, key #1 on the keyboard 
is depressed. The time of each event, 
excepting the first which occurred at t 
= is displayed on the six digit read- 
out for several seconds before the dis- 
play moves to the time of the next 
event. This gives the experimenter 
time to record the data on paper. If 
more time is required, increase the 
value of the number stored in location 
0289. 
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Table 4 also lists the measured time 
interval and gives the percent error 
between the stated interval (say 100 
microseconds) and the actual measured 
interval (99.98 microseconds). The 
measurements were made by connecting a 
frequency counter (PASCO SCIENTIFIC 
Model 8015) to pin PB7 while the pro- 
gram was running and after the first 
event had started the timer. If great- 
er accuracy is required for the 10 mil- 
lisecond and 100 millisecond intervals, 
then experiment with putting NOP in- 
structions between the PHA instruction 
and the LDA TIME instruction in the 
timer program. 

Experiments and Applications 

The simplest application for the pro- 
gram is a simple stopwatch with memory. 
Any suitably debounced switch can be 
used. See pages 213 and 280 in CMOS 
COOKBOOK by Don Lancaster, published by 
Howard W. Sams & Co., Inc., 4300 West 
62nd St., Indianapolis, Indiana 46268 
for some suitable switching circuits. 

Being a physics teacher, I originally 
designed the program to collect data 
for an "acceleration of gravity" exper- 
iment in the introductory physics lab. 
The technique may be applicable to 
other problems so it is described here- 
in. Nine phototransistors (Fairchild 
FPT 100 available from Radio Shack) 
were mounted on a meter stick at 10 cm 
intervals. An incandescent (do not try 
fluorescent lighting) 150 watt flood 
lamp provided the illumination. The 
interface circuit is shown in Figure 1. 

The 555 timer serves as a Schmitt trig- 
ger and buffer which produces a nega- 
tive pulse when an object passes be- 
tween the light and the phototransis- 
tor. The 500 kilo ohm potentiometer is 
adjusted so that an interruption of the 
light to any of the phototransistors 
increases the voltage at pin 2 of the 
555 from about 1.5 volts to at least 
3.5 volts; a very simple adjustment 
which should be made with a VTVM or 
other high impedance meter. 

In the case of a simple pendulum, the 
relationship between the period and the 
amplitude can be investigated by allow- 
ing the pendulum to "run down" while 
logging the times when the bob inter- 
rupts the light to a single phototrans- 
istor. With only one phototransistor 



the timer-data logging program can also 
be used as a tachometer if a rotating 
system of some kind is involved. 

Lancaster, in the CMOS COOKBOOK, des- 
cribes a tracking photocell pickoff 
which could be used in conjunction with 
the program for outdoor races and other 
sporting events. See page 346 in the 
"COOKBOOK". A simple light beam-photo- 
transistor system could be placed in a 
cage and the apparatus would record the 
times at which an animal interrupted 
the beam, giving a measurement of ani- 
mal activity. 

If you want to measure the muzzle vel- 
ocity of your rifle or handgun, you 
will have to be more devious. First, I 
would modify the program so that one 
pin, say PA0, is used to start the tim- 
ing while another pin, say PB0, is used 
to stop the timing. This can be ac- 
complished by changing instructions 
0226 and 022D in Table 1 from AD 00 17 
to AD 02 17. Then I would use a fine 
wire foil to hold the clock input of a 
7474 flip-flop low until the wire foil 
was broken by the exit of the bullet 
from the gun. The Q output going high 
would start the timing, so it would be 
connected to PA0. To end the timing 
one could use a microphone to detect a 
bullet hitting the backstop. Of 
course, the microphone signal would 
have to be amplified and used to trig- 
ger say the other flip-flop of the 7474 
to signal the second event. So as not 
to take all your fun away, that is the 
last hint except that the distance be- 
tween start and stop should be at least 
10 feet. Please be careful. 

I would like to acknowledge the educa- 
tion and inspiration I received at an 
NSF Chautauqua Type Short Course and a 
KIM workshop, both conducted by Dr. 
Robert Tinker. 



[Editor's Note: For a related KIM-1 
application, see "A Simple Frequency 
Counter Using the KIM-1", by Charles R. 
Husbands, on page 26 of this issue.] 
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DLOG ORG $0200 









LOW 


* 


$0000 








MID 


* 


$0001 








HIGH 


* 


$0002 








N 


* 


$0003 








LO 


* 


$0003 








MI 


* 


$0053 








HI 


* 


$00A3 








INH 


« 


$00F9 








POINTL 


* 


$OOFA 








POINTH 


* 


$OOFB 








KEY 


* 


$0271 








PAD 


* 


$1700 








GETKEY 


* 


$1F6A 








SCANDS 


* 


$1F1F 


0200 78 






INIT 


SEI 




0201 F8 








SED 




0202 A2 


00 






LDXIM 


$00 


0204 A9 


50 






LDAIM 


$50 


0206 8D 


FE 


17 




STA 


$17FE 


0209 A9 


02 






LDAIM 


$02 


02 OB 8D 


FF 


17 




STA 


$17FF 


020E A9 


99 






LDAIM 


$99 


0210 85 


00 






STAZ 


LOW 


0212 85 


01 






STAZ 


MID 


0214 85 


02 






STAZ 


HIGH 


0216 AD 


00 


17 


START 


LDA 


PAD 


0219 29 


01 






ANDIM 


$01 


021B DO 


F9 






BNE 


START 


02 1D AD 


00 


17 


FLIP 


LDA 


PAD 


0220 29 


01 






ANDIM 


$01 


0222 FO 


F9 






BEQ 


FLIP 


0224 58 








CLI 




0225 00 








BRK 




0226 EA 








NOP 




0227 AD 


00 


17 


CHEK1 


LDA 


PAD 


022A 29 


01 






ANDIM 


$01 


022C DO 


F9 






BNE 


CHEK1 


022E AD 


00 


17 


CHEK2 


LDA 


PAD 


0231 29 


01 






ANDIM 


$01 


0233 FO 


F9 






BEQ 


CHEK2 


0235 E8 








INX 




0236 A5 


00 






LDAZ 


LOW 


0238 95 


03 






STAZX 


LO 


023A A5 


01 






LDAZ 


MID 


023C 95 


53 






STAZX 


MI 


023E A5 


02 






LDAZ 


HIGH 


0240 95 


A3 






STAZX 


HI 


0242 E4 


03 






CPXZ 


N 


0244 DO 


E1 






BNE 


CHEK1 


0246 78 






DISPLA 


SEI 




0247 4C 


71 


02 




JMP 


KEY 



Table 1 
Data logging program 



DISABLE INTERRUPT 

SET DECIMAL MODE 

SET X = 

SET INTERRUPT VECTOR = 0250 



INIT COUNTER BY STORING 255 (FF) 

INT THE THREE, TWO DIGIT 

MEMORY LOCATIONS OF THE 

COUNTER 

READ INPUT PIN PAO 

LOGICAL AND WITH PAC 

LOOP IF PIN IS 1 

IF PIN IS NOT 1, READ AGAIN 

LOGICAL AND WITH PAO 

LOOP IF PIN IS 

ELSE, ENABLE INTERRUPT AND JUMP TO 

TIMER PROGRAM THEN RETURN 

PADDING FOR BRK COMMAND 

THESE INSTRUCTIONS ARE THE SAM 

AS THE START AND FLIP SEQUENCE 



INCREMENT X FOR EACH DATA POINT 
COUNTER CONTENTS ARE STORED IN A 
SEQUENCE OF LOCATIONS INDEXED 
BY X 



COMPARE X TO N. RETURN TO CHEK1 
IF X IS LESS THAN N 
ELSE GO TO DISPLAY AFTER 
DISABLING INTERRUPTS 



23 



TIMER ORG $0250 



TIME • 

TIMEX • 

LOW * 

MID « 

HIGH • 



$0049 
$170C 
$0000 
$0001 
$0002 



0250 48 INTRPT PHA 

0251 A9 49 LDAIM TIME 
0253 8D OC 17 STA TIMEX 
0256 A9 01 LDAIM $01 
0258 65 00 ADCZ LOW 
025A 85 00 STAZ LOW 
025C A9 00 LDAIM $00 
025E 65 01 ADCZ MID 
0260 85 01 STAZ MID 
0262 A9 00 LDAIM $00 
0264 65 02 ADCZ HIGH 
0266 85 02 STAZ HIGH 

0268 68 PLA 

0269 40 RTI 



Table 2 
Timer program 



PUSH ACCUMULATOR ON STACK 
START TIMER FOR 49(16) CYCLES 

INCREMENT COUNTER BY ADDINT 1 
TO THE TWO LOW DIGITS 
AND STOR RESULT 
ADD CARRY FROM PREVIOUS 
ADDITION TO MID DIGITS. IF 
CARRY OCCURS FROM THE TWO MID 
FROM THE TWO MID DIGITS, THEN 
ADD THIS TO THE TO HIGH DIGITS 

PULL ACCUMULATOR FROM STACK 
RETURN TO DATA LOGGER 




£>>PA<* 



Figure 1 

Interface circuit using 
up to 10 phototransis- 
tors. The dashed line 
represents other photo- 
transistors. The time 
at which the light to 
any of the phototransis- 
tors is interrupted is 
recorded by the timer- 
data logging program. 



.Olmf 
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DISPLA ORG $0271 











N 


* 


$0003 












LO 


* 


$0003 












MI 


* 


$0053 












HI 


« 


$00A3 


Table 3 










INH 


» 


$00F9 












POINTL 


* 


$00FA 


Display program 










POINTH 


« 


$00FB 












INIT 


* 


$0200 












TIME 


» 


$1707 












GETKEY 


« 


$1F6A 












SCANDS 


* 


$1F1F 




0271 


20 


6A 


1F 


KEY 


JSR 


GETKEY 


JUMP TO KIM KEYBOARD MONITOR 


0274 


C9 


01 






CMPIM $01 


TEST VALID INPUT 


0276 DO 


F9 






BNE 


KEY 


IF NOT, WAIT FOR INPUT 


0278 A2 


01 






LDXIM 


$01 


INIT X REGISTER TO INDEX 


027A 


B5 


03 




NXPNT 


LDAZX 


LO 


DATA POINTS 


027C 


85 


F9 






STAZ 


INH 


PUN IN KIM DISPLAY REGISTERS 


027E 


B5 


53 






LDAZX 


MI 




0280 


85 


FA 






STAZ 


POINTL 




0282 


B5 


A3 






LDAZX 


HI 




0284 


85 


FB 






STAZ 


POINTH 




0286 


8A 








TXA 




SAVE X WHILE IN SUBROUTINE BY 


0287 


48 








PHA 




PUSHING IT ON THE STACK 


0288 


AO 


10 






LDYIM $10 


TIME TO DISPLAY EACH POINT 


028A 98 






AGN 


TYA 




SAVE Y WHILE IN SUBROUTINE BY 


028B 


48 








PHA 




PUSHING IT ON THE STACK 


028C 


A9 


FF 






LDAIM 


$FF 




028E 


8D 


07 


17 




STA 


TIME 




0291 


20 


1F 


1F 


REPEAT 


JSR 


SCANDS 


SCANDS IS KIM ROUTINE WHICH 


0294 


AD 


07 


17 




LDA 


TIME 


DISPLAYS DATA IN 00F9, OOFA 


0297 


30 


03 






BMI 


OVER 


AND OOFB. REPEATED JUMPS TO 


0299 


4C 


91 


02 




JMP 


REPEAT 


SCANDS PRODUCES A CONSTANT DISPl 


029C 


68 






OVER 


PLA 




RESTORE Y REGISTER 


029D 


A8 








TAY 






029E 


88 








DEY 




DECREMENT Y BY 1 AND REPEAT 


029F 


FO 


03 






BEQ 


HOP 


DISPLAY UNTIL Y = 


02A1 


4C 


8A 


02 




JMP 


AGN 




02A4 


68 






HOP 


PLA 




RESTORE X REGISTER 


02A5 


AA 








TAX 






02A6 


E4 


03 






CPXIM 


N 


COMPARE X WITH N. IF X IS LESS 


02A8 


FO 


04 






BEQ 


BEGIN 


THAN N INCREMENT X AND DISPLAY 


02AA 


E8 








INX 




NEXT POINT. ELSE, RETURN TO 


02AB 


4C 


7A 


02 




JMP 


NXPNT 


THE BEGINNING 


02AE 


4C 


00 


02 


BEGIN 


JMP 


INIT 




Table 4 


\ 






Time Interval Value Address Measured Interval 


Timing intervals 




100 microsec 


49 


170C 99.98 microsec 


for the program. 




1 mi 


.llisec 


7A 


170D 0.9998 millisec 










10 mi 


.llisec 


: 9C 


170E 10.007 millisec 










100 mi 


.llisec 


: 62 


170F 100.5 millisec 



% Error 

0.02% 

0.02$ 
0.07% 
0.5% 
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h SIMPLE FKEfflOEINCY COUNTER 
USING TIME KIN-1 



Charles R. Husbands 

24 Blackhorse Drive 

Acton, MA 01720 



A piece of test equipment that is oc- 
cassionally very useful in the computer 
laboratory is a frequency counter. 
This article explains how to use the 
capabilities of the KIM-1, with a mini- 
mum of additional hardware, to provide 
the functions of such an instrument. 
The frequency counter described oper- 
ates over the audio range from 500 Hz 
to above 15 KHz. To reduce the amount 
of external hardware needed, the design 
assumes TTL level input signals. How- 
ever, the addition of a small amount of 
analog hardware to the design presented 
would allow the counter to be used with 
analog signal sources. 

Basic Counter Mechanization 

In order to develop a frequency counter 
from the KIM-1 microcomputer it is nec- 
essary to count and display the number 
of input pulses detected over a specif- 
ic time interval. The basic time in- 
terval chosen was 100 milliseconds. 
This time interval is established by 
using one of the two interval timers 
available on the KIM-1 . Transitions in 
the applied waveform are sensed by the 
external logic and force non-maskable 
interrupts to the KIM. As each inter- 
rupt is detected a memory location is 
incremented. Because of the availabil- 
ity of the decimal mode in the 6502 in- 
struction set, the count can be main- 
tained in decimal rather than binary or 
hexadecimal form. At the conclusion of 
the 100 millisecond interval the accum- 
ulated count is loaded into the display 
registers and the process is repeated. 
Figure 1 is a flow chart of the freq- 
uency counter program. 

Detailed Software Description 

As shown in the flow chart (Figure 1) 
and in the program listing (Figure 2) 
the program is started at location 0005 
and the frequency counter memory loca- 
tion and display locations are initial- 
ized to zero. A Value of 99. is loaded 
into the interval counter at location 
1747. A value stored at this location 



is decremented every 1024 microseconds. 
Under these conditions a zero register 
value will then be realized 101.376 
milliseconds after the register is 
loaded. 

After the initialization process the 
program goes into an idle loop called 
DISPLAY and waits for an interrupt to 
occur. The DISPLAY program consists of 
repeated calls to the KIM display rou- 
tine which presents the contents of the 
display registers 00FA and 00F9 on the 
seven segment display LEDs. 

When an IRQ interrupt is sensed, the 
KIM logic forces program control to the 
address stored in memory locations 17FE 
and 17FF. In this mechanization, the 
value stored in these locations will 
direct program control to be trans- 
ferred to the start of the interrupt 
routine (location 0021). The interrupt 
program first stores away the values of 
A and X from the interrupted program. 
The contents of the interval timer reg- 
ister, location 1746, is then read to 
establish if the 100 millisecond inter- 
val has been completed. A non zero 
number indicates that the counter is 
still counting and an input pulse 
transition has been detected. The log- 
ic sets the processor into the decimal 
mode and adds one to the contents of 
the frequency counter location. As we 
wish to detect values above 1 KHz, a 
second frequency counter register must 
be employed to count the overflow from 
the least significant two decimal dig- 
its. Having completed the incrementa- 
tion process, the program restores the 
the values of A and X and returns to 
the interrupted program by executing 
the RTI instruction. 

If a zero value is observed when the 
interval timer register is read, then 
the 100 millisecond timing interval has 
been completed. The program reloads 
the 100 millisecond value into the in- 
terval counter, loads the accummulated 
count in the frequency counter memory 
locations into the appropriate display 
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c 



START 



I 



3 



INITIALIZE COUNTERS AND DISPLAYS 



SET INTERVAL COUNTER FOR 100 MS 



< 



DISPLAY 



Jl 



3 



EXECUTE KIM DISPLAY ROUTINE 



c 



INTERRUPT 

3 



J 




YES 



SET INTERVAL COUNT 
FOR 100 MS 



LOAD FREQ COUNTER 
INTO DISPLAY REG. 





♦ 






1 


INCREMENT FREQUENCY COUNTER 




ZERO FREQ COUNTER 
LOCATIONS 








i 


f* 






RETURN FROM INTERRUPT 





FLOW DIAGRAM FOR FREQUENCY COUNTER PROGRAM 



Figure 1 
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ORG $0005 











INTGER 


» 


$OOFA 










FRACT 


* 


$00F9 










PBDD 


* 


$1703 










CLOCKX 


* 


$1746 










CLOCK 


* 


$1747 










SCANDS 


* 


$1F1F 


0005 


A9 


00 




START 


LDAIM 


$00 


0007 


85 


51 






STAZ 


CNTONE 


0009 


85 


52 






STAZ 


CNTTWO 


000B 


85 


FA 






STAZ 


INTGER 


OOOD 


85 


F9 






STAZ 


FRACT 


OOOF 


8D 


03 


17 




STA 


PBDD 


0012 


A9 


62 






LDAIM 


$62 


0014 


8D 


47 


17 




STA 


CLOCK 


0017 


20 


1F 


1F 


DISPLA 


JSR 


SCANDS 


001A 


4C 


17 


00 




JMP 


DISPLA 



Figure 2 



INIT COUNTERS AND DISPLAY 



SET UP 100 MILLISECOND TIMER 



DISPLAY DATA 
CONTINUOUSLY 

0021 ORG $0021 

0021 48 INTRPT PHA SAVE A REGISTER 

0022 8A TXA SAVE X REGISTER 

0023 48 PHA 

0024 AD 46 17 LDA CLOCKX TEST CLOCK TIMED OUT 
0027 30 11 BMI MILLI TEST OF 100 MILLISECONDS 

0029 F8 COUNT SED SET DECIMAL MODE 

002A 18 CLC CLEAR CARRY BIT 

002B A5 51 LDAZ CNTONE GET FRACTIONAL PART 

002D 69 01 ADCIM $01 INCREMENT 

002F 85 51 STAZ CNTONE 

0031 A5 52 LDAZ CNTTWO ADD CARRY BIT IF SET 

0033 69 00 ADCIM $00 

0035 85 52 STAZ CNTTWO 

0037 4C 4D 00 JMP EXIT 

003A A9 62 MILLI LDAIM $62 RESET CLOCK 

003C 8D 47 17 STA CLOCK 

003F A5 51 LDAZ CNTONE MOVE DATA TO DISPLAY 

0041 85 F9 STAZ FRACT 

0043 A5 52 LDAZ CNTTWO 

0045 85 FA STAZ INTGER 

0047 A9 00 LDAIM $00 RESET COUNTERS 

0049 85 51 STAZ CNTONE 
004B 85 52 STAZ CNTTWO 

004D 68 EXIT PLA RESTORE X REGISTER 

004E AA TAX 

004F 68 PLA RESTORE A REGISTER 

0050 40 RTI RETURN FROM INTERRUPT 

0051 00 CNTONE = $00 FRACTIONAL COUNTER 

0052 00 CNTTWO = $00 INTEGER COUNTER 
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registers, and then zeros the contents 
of the frequency counter locations. 
The interrupt program is exited by re- 
storing the values of A and X and re- 
turning via the RTI instruction. 

The Hardware Configuration 

Figure 3 illustrates the additional 
logic required to use the KIM as a fre- 
quency counter and shows how that logic 
is connected to the KIM Expansion con- 
nector. The purpose of the 74121 mono- 
stable multivibrator is to produce a 
negative going pulse of short duration 
onto the IRQ interrupt lines whenever 
the input to that chip experiences a 
high-to-low transition. It should be 
noted that the IRQ is a level rather 
than an edge sensitive interrupt and 
that the interrupt line must be held 
low only long enough to allow the pro- 
cessor to sense the interrupt. There- 
fore, with the addition of this flip- 
flop the KIM will experience an IRQ in- 
terrupt each time the input source ex- 
hibits a high-to-low transition. If a 
periodic pulse train is being applied 
to the input, then an IRQ interrupt 
will be experienced on each cycle. 



9 VCC +5 volts 
(E-21) 




GND (E-22) 



The accuracy of this hardware/software 
on a KIM-1 for measuring frequencies is 
shown in the table (Figure 4). A very 
accurate frequency meter was used to 
obtain the meter measurements. Since 
there are probably slight variations in 
the speed of different KIM-1s, you 
should calibrate your own unit before 
using it for any "real" measurements. 



equency 


Calibration 


Meter 


KIM 


14.960 


15.00 


13.961 


14.00 


12.960 


13.00 


11.968 


12.00 


10.966 


11.00 


9.965 


10.00 


8.970 


9.00 


7.977 


8.00 


6.984 


7.00 


5.983 


6.00 


4.985 


5.00 


3.992 


4.00 


2.991 


3.00 


2.003 


2.00 


1.003 


1.00 


.902 


0.90 


.801 


0.80 


.705 


0.70 


.608 


0.60 


.507 


0.50 



Figure 3 



Figure 4 



Additional Comments 

In addition to entering the values 
shown in the accompanying listing, the 
values 0010 should be stored in loca- 
tions 17FA and 17FB, ana 2100 should be 
stored in locations 17FE and 17FF. The 
latter value directs program control to 
the beginning of the interrupt routine 
when an IRQ is sensed. 

The results displayed on the seven seg- 
ment indicators will be in the form 
XX. XX KHz. This format was chosen for 
convenience and the range can be shift- 
ed for higher accuracy by software mod- 
ifications. Additional improvements 
are left to the reader to create. The 
author would appreciate being informed 
of any interesting improvments you come 
up with. 
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DIGITAL-ANALOG AND ANALOG-DIGITAL CONVERSION 
USING THE KIM-1 

Marvin L. De 3ong 

Department of Math-Physics 

The School of the Dzarks 

Point Lookout, MO 65726 



A Motorola 1408 8-bit digital to analog conver- 
ter is connected as shown in the circuit dia- 
gram. (The 1408 is available from James Elec- 
tronics, 1021 Howard Ave., San Carlos, CA 94070, 
as are the op amps used in these experiments.) 
The PAD port of the KIM is used to provide the 
digital input to the 1408. The analog output of 



the 1408 is a current sink at pin 4, which we 
converted to a voltage by means of the RCA CA- 
3140 operational amplifier. The feedback resis- 
tor R is adjusted to give the desired voltage 
output. For example, an R of about 500 ohms 
gives a voltage range from volts when PAD is 
00000000 to 1 volt when PAD is 11111111. 



Circuit Diagram for 
Digital to Analog Converter 



PBQ 



SCOPE SYNC 

to scope 



+ ISV 




*PB7 



1 . Generation of a Ramp Voltage Waveform 

For the first experiment do not connect the sec- 
ond op amp, simply connect the output of the 



first op amp to an oscilloscope as shown, 
the following program. 



Load 



Program to Generate a Ramp Voltage Waveform 



ADDRESS OPCODE 



LABEL INSTRUCTION COMMENTS 



0300 


A9 FF 




0302 


8D 01 


17 


0305 


EE 00 


17 


0308 


4C 05 


03 



START LDAIM FF 255 in Accumulator 

STA PADD Port A is Output Port 

BACK INC PAD Increment number in PAD 

JMP BACK Increment in a Loop 



Running this program should cause a ramp wave- 
form to be observed on the oscilloscope screen. 
A close examination of the ramp will show that 
it consists of 2 8 = 256 steps rather than a 
straight line . 

2. A DAC as an Analog to Digital Converter 

The second op amp acts as a comparator . It com- 
pares the voltage from the output of the first 
op amp (which we shall call the digital signal) 
with a voltage from some source to be applied to 
pin 3 (which we shall call the analog signal) . 
The output is connected to PB7 on the KIM. If 
PB7 = 1 , the analog signal is greater than the 
digital signal . If PB7 = , the analog signal 
is less than the digital signal. The digital 
signal is , of course , produced by the contents 
of PAD. 



A flow chart showing what we intend to do is 
shown below. Output port PAD is set to zero. If 
the analog signal is positive the PB7 = 1 . PAD 
is now incremented until the comparator indi- 
cates that the analog signal is less than the 
digital signal, i.e., PB7 =0. At that instant 
the digital and analog signals are the same to 
within one bit, the least significant bit, on 
PAD. The digital value of PAD is then displayed 
and the cycle continues. 

If the feedback resistor is adjusted so that a 
value of PAD = 255 l0 = FF, t produces a voltage 
of 2.55 volts, then we have constructed a simple 
digital voltmeter with a full scale reading (in 
hex) of 2.55 volts. The extremely high imped- 
ance of the 3140 op amp makes this a rather good 
voltmeter. A simple program to convert from hex 
to base ten would make the meter easier to read. 
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Flow Chart for 
Analog to Digital Converter 




MgAD = PAD+T) 



1 



DISPLAY PAD 
CONTENTS ON 
KIM 



Program for Analog to Digital Converter 
(Ramp Approximation) 



ADDRESS OPCODE LABEL INSTRUCTION COMMENTS 



0300 


A9 FF 


START 


LDAIM 


FF 


0302 


8D 01 17 




STA 


PADD 


0305 


A2 00 


AGN 


LDXIM 


00 


0307 


8E 00 17 


RAMP 


STX 


PAD 


030A 


AD 02 17 




LDA 


PBD 


030D 


10 04 




BPL 


DISP 


030F 


E8 




INX 




0310 


4C 07 03 




JMP 


RAMP 


0313 


86 F9 


DISP 


STX 


INH 


0315 


20 1F 1F 




JSR 


SCANI 


0318 


4C 05 03 




JMP 


AGN 



255 in Accumulator 
Make Port A Output Port 
Start PAD at zero 
Output Value of X register 
Read Port B 
Branch if bit 7=0 
Increment X register 
Continue loop 

Put X into Display register 
SCANDS Use KIM Display Subroutine 
and start again at zero 



3. Successive Approximation Analog to Digital 
Used as a Storage Scope. 

The r-aniD approximation is quite slow and there 
is a faster technique known as "successive ap- 
proximation." It works as follows: the most 
significant bit to the DAC is set to one and all 
the others are set to zero. If the comparator 
indicates that the analog signal is greater than 
the digital signal , the next lower bit is set 
to 1 and the test is repeated . If the comDara- 
actor indicates that the analog signal is less 
than the digital signal , the highest bit is made 
zero, and the next lower bit is set to 1 and the 
test is repeated. This iterative process is re- 
peated until all eight bits have been tested, 
starting with the MSB and ending with the LSB. 
The flow chart indicates how this will be accom- 
plished . 

This analog to digital conversion scheme will 
be used in a program which digitizes 256 points 
on a waveform and then stores the results, to be 
displayed at a convenient time and with as many 
repetitions as desired on an oscilloscope. It 
is useful for examining slow waveforms with an 
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oscilloscope with a low persistance screen, for 
example ECG waveforms, and it is useful for ex- 
amining non-periodic waveforms such as a one- 
shot impulse from an accelerometer. The program 
has triggering built in, and the output scan 
portion synchronizes the oscilloscope with a 
sync signal, turning an inexpensive scope into 
something more useful. A flow chart for the 
program is given below. 

A short description of the behavior of the cir- 
cuit and program follows. the experimenter 
chooses the desired trigger level and loads this 
into location 0306. When the analog signal is 
greater than this, the comparator makes PB7 go 
high and the scan begins. The sampling rate 
and the scan time is determined by the number 
loaded into the timer and the timer used; loca- 
tions 0314 and 0316, respectively. It takes at 
least 200 microseconds to digitize so there is 
no point in choosing time intervals smaller than 
this. X is used as an index to identify each of 
the 25b points on the scan. Alter the timer is 
started the analog signal is digitized and the 
timer is watched until it is finished. x is 
then incremented and a new point is digitized 



Flow Chart for 

Successive Approximation 

Analog to Digital Conversi on 



PAD = 80 16 = 10000000 
PGZZ = 80 6 = 10000000- 




YES 



PAD = PAD - PGZZ 



LOGICAL SHIFT RIGHT PGZZ, 
(Shifts all bits one bit 
right and zero bit is 
shifted into carry bit.) 




Flow Chart for Storage Scope 




(x RE G = 0) 




( GO TO "\ 
'y. DISPLAY ) 



until all 256 points are finished and stored in 
TABLE ,X. 

X is then zero again. This entire process will 
repeat unless the 1 key is depressed, in which 
case the program displays the data on the oscil- 
loscope , connected as before to the output of 
the first op amp. The display will repeat, com- 
plete with SYNC signal output from PBO, until 
the program is halted. In our case we loaded 
the vector 17FA and 17FB with the starting add- 
ress of the program (0300) so a depression of 
the ST key caused the entire program to start 
over. 

A listing of the program is shown on the follow- 
ing page. Notice that the data is stored in 
TABLE, X located in page 2 of memory, PGZZ is at 
location 0000, the trigger level is in 0306 and 
the scan time variable is in 0314 and 0316. The 
scan time should not be shorter than 200 micro- 
seconds. As far as display is concerned, we 
found that a sweep rate of 200 to 500 micro- 
seconds per cm gave good results. 

A few other comments may be in order. First, 
most of the ideas for this project were obtained 
in a KIM workshop offered by Dr. Robert Tinker. 
The software implementation is the author's 
work. There are some obvious improvements, such 
as a sample and hold device between the analog 
source and the comparator or a faster approxim- 



ation routine. These improvements are left for 
the reader to implement . The author would be 
glad to be informed if such improvements are 
made . 



Flow Chart for Display 



( §ET X = J 



-<- 



( SYNC SCOpF ) 



PUT 
TABLE (X) 
INTO PAD 



( k = X + 1~") 




YES 
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Program for Storage Scope 



ADDRESS OPCODE LABEL INSTRUCTION COMMENTS 



0300 

0302 

0305 

0307 

030A 

030C 

030D 

030E 

0311 

0313 

0315 

0318 

031A 

031C 

031F 

0322 

0324 

0325 

0327 

0329 

032B 

032D 

0330 

0333 

0336 

0337 

0339 

033C 

033E 

0341 

0344 

0346 

0348 

034B 

034D 

0350 

0352 

0355 

0357 

035A 

035D 

0360 

0361 

0363 



A9 FF BEGIN LDAIM 

8D 01 17 STA 

A9 10 START LDAIM 

8D 00 17 STA 

A2 00 LDXIM 

EA NOP 

EA NOP 

AD 02 17 TRIG LDA 

10 FB BPL 

A9 CO STIME LDAIM 

8D 05 17 STA 

A9 80 LDAIM 

85 00 STAZ 

8D 00 17 TEST STA 

AC 02 17 LDY 

30 03 BMI 

38 SEC 

E5 00 SBCZ 

46 00 FWRD LSRZ 

BO 08 BCS 

65 00 ADC 

4C 1C 03 JMP 

8D 00 1-7 OUT STA 

9D 00 02 STAX 

E8 INX 

FO 08 BEQ 

AD 07 1-7 CHEK LDA 

10 FB BPL 

4C 13 03 JMP 

20 6A IF DISPLY JSR 

C9 01 CMPIM 

FO 03 BEQ 

4C 05 03 JMP 

A9 01 SYNC LDAIM 

8D 03 17 STA 

A2 00 LDXIM 

AD 02 17 RPT LDA 

49 01 EORIM 

8D 02 17 STA 

BD 00 02 SCAN LDAX 

8D 00 17 STA 

E8 INX 

DO F7 BNE 

4C 52 03 JMP 



FF Initialize Port A to Output 

PADD 

TSET Trigger Voltage Set 

PAD 

00 Initialize X register 



PBD Tinput and test PB7 

TRIG Wait if PB7 = 

CO Set Scan Time here 

TIMER Select Interval Timer 

80 Start Digitize Sequence 

PGZZ Store Initial Value 

PAD Output Value 

PBD Test PB7 

FWRD Branch if PB7 = 1 

Clear Borrow Flag 

PGZZ Subtract bit 7 

PGZZ Set PGZZ for Next Lower Bit 

OUT Out of Digitize Loop if Finished 

PGZZ Set Next Lower Bit = 1 

TEST Return to Test all Lower Bits 

PAD Final Approximation in PAD 

TABLE and in TABLE (X) in Page 2 

Bump Table Index 
DISPLY Go to Display if Table Complete 

TCHEK Test if Timer is Finished 

CHEK If not, Wait in Loop 

STIME Digitize another Point 
GETKEY Is Key 1 Depressed? 
01 

SYNC Yes. Display the Data 

START No. Return to Start 

01 Set up PB0 as Sync 

PBDD Output Pin 

00 Init X to Display Table 
PBD Toggle PB0 for Sync 

01 Signal to Scope 
PBD 

TABLE Output Table (X) for 

PAD Display on Scope 

Increment X register 

SCAN Continue until all Points Done 

RPT Then Repeat 



NOTE: This material was submitted by the author 
to the KIM-1 User Notes and has also been dis- 
tributed by MOS Technology as "KIM Application 



Note #11701." It is printed here with the per- 
mission of the KIM-1 User Notes and MOS Technol- 
ogy. 
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MAKING MUSIC MITH THE KIM-1 

Armand L. Camus 

P.O. Box 294 

West ford, MA 01886 



What kind of music can you make with the help of 
a microcomputer, namely the KIM-1 with its 1 . 1K 
bytes of memory? Well, it certainly will not 
sound like the Boston Symphony Orchestra , live 
or on records, but with the right type of music 
it will give an acceptable rendition of a chosen 
piece of music . Many elements of good music 
will be missing, especially the timbre of the 
different instruments of the orchestra , but on 
the positive side the notes will be on tune , you 
will be able to compose in four-part harmony, 
the tempo will be adjustable, and the whole pro- 
cess will permit some of the artistic creativity 
which may hide in each of us to emerge to the 
surface. Last, but not least, it will be a lot 
of fun. 

This elementary article explains the "HOW-TO" 
rather than the "WHY" in making music, with a 



microcomputer. Many of the hobbyists who may 
find it too simple may refer to the excellent 
article by Hal Chamberlin which dwells in detail 
on the subject. 

An easy way for the beginner to start his musi- 
cal career is to acquire a minimum of equipment 
besides the KIM-1 and cassette recorder it is 
assumed are already in his possession. 

The DAC unit is a printed circuit board contain- 
ing a complete audio output system for the 
KIM-1. This board also comes with a cassette 
tape , an instruction sheet listing the songs 
which can be loaded in the KIM, and reprint of 
the reference article including the interconnec- 
tions to be made between the two connectors. 







Kit* 

£■ 


1-1 
in 



J1, J2 connectors: Vector R644, Winchester 
HKD2250, or equivalent. J2 will be too long, 
but will work just the same. 

Speaker, 2 1/2", 8 ohm, 0.3W, from Radio Shack, 
or equivalent. 



Now that we have described the hardware we will 
concentrate on what to do in order to get some 
music out of the system. The simplest way at 
this time is to load File 1 and File 2 of the 
tape and to see if the Star Spangled Banner 
comes out clear and patriotic. The procedure is 
simple : 

Start the KIM-1 and press the appropriate keys 
to get : 

AD 00F1 DA 00 
AD 17F9 DA 01 
AD 1873 Press GO 

Start the cassette until you get 0000 in the ad- 
dress display, which indicates that the loading 
was done properly. After stopping the cassette, 
press the keys to get : 

AD 17F9 DA 02 
AD 1873 Press GO 



Start the cassette again until you get 0000 . 
Stop the cassette. Now you are ready. Press AD 
0100, press GO and the song will be played. As 
it stops, the program resets the address AD to 
0100, so by pressing GO again, the song will 
repeat itself. 

In the same manner you could load Files 3 and 4 
to get a rendition of Exodus. The sound quality 
may be changed by loading File 5 or File 6. 
Personally, I prefer File 6 which has a much 
more mellow timbre . 



Transcribing a Song 

Now that we have gone through the above steps, 
we will learn to code a song . For our purpose , 
a particular note of music will have two charac- 
teristic elements : 

its pitch, represented by its position -on 

the staff; 

its duration , relative to other notes . 
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1. Duration Code: 

We will assign a two-digit code to the 
duration of a note: 

o = FF d = 80 J-=60 J=40 
J.=30 ^=20 «fc-IO 



Pitch Code: 



J NOT* 
COOS 



^ -Q- J>jO. 



fr*Q- o bo 



O bO Q j>Q j 



62 60 



5* SC 



~H£ G~ 



6b F B"~ 
5-6 r«f sa 



"IE - ? - 

So 4E 



~p£ C~~ 



V rf©TS 

CO0C 



O bo 



=£e= 



zo: 



c © e>i q Rb g Gb r r 

Vfl <f8 <►* 44 V2. <(« 3E 3C 3fl 



^° o l^o 1 



ffb I> Pb C 
38 36 3^ 32. 



<7): 


•&- 


o 


feo. 


-O- 


^-e- 


C3 


-ira- 


-©- 


o 


-H-r-r 


o -bo 


Copff 


c 
32 


e 

30 


6b 
2e 


2c 


nb 
2ft 


G 
28 


Gb 
26 


F 
If 

-F— 


— 6- 


•2o 
— efc^ 


P Pb 

IE IC 

-b — Pb— e — 


CoOS 


O 

c 


'8 


6b 
16 


a 

A 


flb 
12. 


G 
(O 


=fc©= 
Gb 
oe 


oc 


Ofl 


08 


06 04- OZ 



What we mean is that a half note lasts twice as 
long as a quarter note , a quarter note lasts 
twice as long as an eighth note, etc... We are 
not talking about tempo yet, this will come 
later. 

With the help of this lookup table we can find 
quickly the code for any note within the limits 
of C6 and'C2, the high and low C's. However, 
the very low notes may not be reproduced too 
well with a small speaker and it may not be ad- 
visable to go below C3 (Code 1A). 

Coding a Song 

The program given at the end of this article is 
a coding of the well-known carol "Deck the 
Halls", which we thought would be appropriate 
for the Christmas Issue. If you look at this 
coding , you will observe that it is done line by 
line. Each line is composed of six elements. 
For example , the first line is : 



0200 60 4A 44 32 24 

- the 0200 is the memory address of the ele- 
ment 60. The next element, 4A, would then 
have an address 0201, and so on. 
the 60 is the duration of the group of four 
A 60 means a dotted 

for the first voice . 

for the second voice . 

for the third voice, 

for the fourth voice. 



notes which follow 
quarter note . 
the 4 A is the note C, 
the 44 is the note A, 
the 32 is the note C, 
the 24 is the note F, 



This is an F major chord which could be repres- 
ented as in (1), and it corresponds to the word 
"DECK" of the song. 

Now we will code the first bar of the song. 
Remember that each line will have the same for- 
mat: 

address (4 digits), duration (2 digits), 1st 
voice (2 digits), 2nd voice (2 digits), 3rd 
voice (2 digits), and 4th voice (2 digits) 
for a total of fourteen (14) digits. If a 
voice is quiet , use 00 at the appropriate 
location . 

The first vertical group of notes (C,A,C,F) cor- 
responding to the word "DECK" has already been 
explained above. 

The second vertical group of notes corresponding 
to the word "THE" is made of B flat, G, C, and 
E. Looking up the pitch code table , we find the 
following codes: 

Bb = 46, G = 40, C = 32, and E = 22. Each 
note is an eighth note so the duration code 
is 20 . The address of the duration code is 
0205 so our second line will be : 

0205 20 46 40 3.2 22 
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In the same fashion the two other vertical 
groups are made of quarter notes (code 40) and 
we get for the first bar: 

0200 60 4A 44 32 24 (DECK) 

0205 20 46 40 32 22 (THE) 

020A 40 44 3C 32 24 (HALLS) 

020F 40 40 3A 2E 1A (WITH) 

Remember that there is a Key Signature in this 
carol and that all the B's, wherever located on 
the staff, are flat, unless otherwise indicated, 
which explains the 46 of the second line and the 
2E of the fourth line. 



Another part of that song is shown in the examp- 
le (3). The first voice plays two notes (A and 
B natural), while the other voices play only 
one. We solve this problem by writing two 
lines , one for the A and one for the B natural , 
repeating the other notes to extend their dura- 
tion to a quarter note . We get : 

02D2 20 44 3C 32 24 
02D7 20 48 3C 32 24 




Both A note (code 44) and B natural note (code 
48) have only the duration of one eighth note 
each ( code 20 ) , and we have to write two sep- 
prate lines for them, but the three other notes 
will be repeated so that their total duration is 
a quarter note. Fortunately, the lower notes, 
even when repeated, will blend together and 
and sound more like a quarter note than two con- 
secutive eighth notes. 

Now we should be abxe to code a song , dux, as a 
preliminary exercise , you may want to load "Deck 
the Halls" and see how it works out. Here is 
the procedure: 

Load Files 01 and 02 of the DAC tape , as expl- 
ained at the beginning of this article. You may 
also want to load File 06 to give a more mellow 
timbre . Then go to address 0200 and start in- 
putting the data. The addresses in the left 
side give you a check on your progress and catch 
possible omissions of data. What we are doing 
here is using the main program and writing over 
the song already in memory. At any time it is 
possible to go back to AD 0100, push GO and lis- 
ten to what is already in memory. Somewhere at 
about 2/3 of the song, we run out of memory 
(0200 to 02F9), but we have enough left to tell 
our microcomputer that it is the end of that 
particular segment (02FA 01), and that we wish 
i-~ continue at address 0083 (02FB and 02FC) . 
At the very end, check address 00DD 00. The 
data 00 indicates the end of the piece and this 
will reset the KIM-1 to address 0100, ready to 
"GO", so to speak. 

After you have loaded the code and pushed the GO 
key, the carol should start, sounding good if no 
mistake was made , but perhaps a little bit on 
.the slojw side_. To change the iempb. either way, 
go to address 00 1D and the data will probably 
show 60. Change the data to 40, go back to ad- 
dress 0100, push GO and the tempo will be much 
faster. Experiment with the data at AD 001D and 
find the tempo you prefer . 

I have found out that while I am coding I like 
to listen to what is already in memory, because 
a simple mistake at the beginning, especially 



forgetting one voice or the duration code, will 
throw the rest out of whack. Starting the song 
at the beginning, when it is already correct is 
a waste of time, but it is possible to start the 
song at some other point. However, it must al- 
ways be at one of the duration addresses shown 
at the end of this article. If not, the KIM-1 
would interpret the duration code as a musical 
note and vice-versa! The starting address is 
contained in locations 0017 and 0018. To start, 
for example, at address 0237. go to address 0017 
read 00, 0018 read 02. This means that the song 
normally starts at 0200. All we have to do is 
change the data to read : 

AD 0017 DA 37 
AD 0018 DA 02 

Then setting address 0100 and pushing GO will 
cause the song to start at location 0237 every 
time. 



Available Memory 

The memory available to the user is divided in 
two groups , each group not necessarily in con- 
secutive order. First aroup is associated with 
the music program, frequency table or tne notes, 
KIM, etc . . . Second group is associated with the 
song . The actual layout of the memory is as 
follows : 

Program variables 
Note frequency table 
Song, second part 
KIM variables 
Music program 
Song , third part 
6502 Stack 
Song , first part 
Waveform (voice) table 
Sone , fourth part 

If your music score extends beyond the first 
part locations, you have to provide room for 
continuation. Assuming a score uses all of the 
available memory space for coding a song, the 
following locations are important : 



0000 


to 


001E 


001F 


to 


0082 


0083 


to 


00EE 


00EF 


to 


00FF 


0100 


to 


01AA 


01 AB 


to 


01F3 


01F4 


to 


01FF 


0200 


to 


02FF 


0300 


to 


03FF 


1780 


to 


17E4 
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line of Location Part 1 Part 2 IflCt 1 

Beginning of Part (Song) 
Beginning of Last Line 
Last note of Last Line 
End of Sequence (Song) 
Low Address Next Segment 
High Address Next Segment 

Reference: Chamberlin, Hal, "A sampling of Techniques for Computer Performance 
of Music", BYTE Magazine, Sept. 1977, PP- 62-83- 



Part 4 



rail, i 
0200 


0083 


01AB 


1780 


02F5 


00E7 


01EC 


17DF 


02F9 


00EB 


01F0 


17E3 


02FA (01) 


00EC (01) 


01F1 (01) 


17E4 (00) 


02FB (83) 


00ED (AB) 


01F2 (80) 




02FC (00) 


00EE (01) 


01F3 (17) 





Score for "Deck the Halls" 



0200: 


60 


4A 


44 


32 


24 


0205: 


20 


46 


40 


32 


22 


020A: 


40 


44 


3C 


32 


24 


020F: 


40 


40 


3A 


2E 


1A 


0214: 


40 


3C 


32 


2C 


IE 


0219: 


40 


40 


3A 


32 


1A 


021E: 


40 


44 


3C 


32 


24 


0223: 


40 


3C 


32 


2C 


24 


0228: 


20 


40 


3A 


32 


1A 


022D: 


20 


44 


3C 


32 


1A 


0232: 


20 


46 


40 


32 


1A 


0237: 


20 


40 


3A 


32 


1A 


023C: 


60 


44 


3C 


32 


24 


0241 : 


20 


40 


36 


2E 


16 


0246: 


40 


3C 


32 


2C 


1A 


024B: 


40 


3A 


32 


28 


1A 


0250: 


80 


3C 


32 


2C 


24 


0255: 


60 


62 


5C 


32 


24 


025A: 


20 


5E 


58 


32 


22 


025F: 


40 


5C 


54 


32 


24 


0264: 


40 


58 


52 


2E 


1A 


0269: 


40 


54 


4E 


2C 


1E 


026E: 


40 


58 


52 


32 


1A 


0273: 


40 


5C 


54 


32 


24 


0278: 


40 


54 


4A 


2C 


24 


027D: 


20 


58 


52 


32 


1A 


0282: 


20 


5C 


54 


32 


1A 


0287: 


20 


5E 


58 


32 


1A 


028C: 


20 


58 


52 


32 


1A 


0291 : 


60 


5C 


54 


32 


24 


0296: 


20 


58 


4E 


2E 


16 


029B: 


40 


54 


4A 


2C 


1A 


02A0: 


40 


52 


4A 


28 


1A 


02A5: 


80 


54 


4A 


2C 


24 


02AA: 


50 


40 


3A 


32 


1A 


02AF: 


20 


44 


3C 


32 


1A 


02B4: 


40 


46 


40 


32 


1A 



02B9: 40 40 3A 32 1A 

02BE: 60 44 3C 32 24 

02C3: 20 46 3C 28 24 

02C8: 40 4A 3C 2C 24 

02CD: 40 40 40 32 22 

02D2: 20 44 3C 32 24 

02D7: 20 48 3C 32 24 

02DC: 40 4A 40 32 22 

02E1 : 20 4E 44 32 24 

02E6: 20 52 44 32 24 

02EB: 40 54 44 32 1E 

02F0: 40 52 40 32 28 

02F5: 40 4E 3C 30 28 

02FA: 01 

02FB: 83 

02FC: 00 



0083: 
0088: 
008D: 
0092: 
0097: 
009C: 
00A1 : 
O0A6: 
00AB: 
00B0: 
00B5: 
00BA: 
00BF: 
00C4: 
0OC9: 
00CE: 
00D3: 
00D8: 
00DD: 



80 4A 3A 28 1A 
60 4A 44 32 24 
20 46 40 32 24 
40 44 3C 32 24 
40 40 3A 2E 
3C 32 2C 



40 



1A 
1E 



20 4E 3C 2E 
20 4E 3C 2E 



40 40 3A 2E 1A 
40 44 3C 32 24 
40 3C 32 2C 24 
16 
16 

20 4E 3C 2E 16 
20 4E 3C 2E 16 
60 4A 3C 2C 24 
25 46 3C 36 28 
50 44 3C 32 1A 
60 40 3A 2E 1A 
95 3C 32 2C 24 
00 
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h COMPLETE MORSE CODE SEINID/RECEIVE 
PROGRAM FOR THE KIM-1 

Marvin L. De Jong, KOEI 

Dept. of Math-Physics 
The School of the Ozarks 
Point Lookout, MO 65726 



I . INTRODUCTION 

The program described below will con- 
vert ASCII from a keyboard to a Morse 
code digital signal which can be used 
to key a transmitter. It will also 
convert a Morse code digital signal to 
ASCII for display on the user's video 
system. Suitable references for cir- 
cuits to convert the audio signal from 
a communications receiver to a digital 
Morse signal are also given. [1,2] 

The entire program resides in the mem- 
ory on the KIM-1, and has the following 
features: 

1 . The precise code speed in words per 
minute can be entered at any time from 
the keyboard. Key in CONTROL S follow- 
ed by any two-digit decimal number from 
05 to 99 words per minute. 

2. The operator can type as many as 
256 characters ahead of the character 
currently being sent. One page of mem- 
ory is devoted to a FIFO buffer. 

3- When there are less than 16 charac- 
ters left in the buffer, the KIM-1 dis- 
play indicates how many characters are 
left (F to hex). 

4. Backspace capability is provided. 
CONTROL B erases the last character en- 
tered into the buffer, and the operator 
then enters the correct character. 

5. The buffer can be pre-loaded with 
as many characters (up to 256) as de- 
sired while the program is in the re- 
ceive mode. Pressing CONTROL G starts 
the program sending code as soon as the 
operator is ready. 

6. CONTROL R sends the program from 
the send mode to the receive mode. 

7. While in the receive mode the dis- 
play on the KIM-1 informs the operator 
to either increase the code speed (F, 
for faster, on the display) or decrease 
(S, for slower) the speed for proper 
reception. The receive program actual- 
ly tolerates a large range in code 
speeds with no adjustment. 



8. The feature just mentioned can be 
used to measure the "other guy's" code 
speed. 

9. If the receive mode is not used, 
any CONTROL key not mentioned above 
will put the program in an idle loop so 
the buffer can be loaded. CONTROL G 
starts the message. 

10. The carriage return key restarts 
the send program, or it can be returned 
from the receive mode to the send mode 
with CONTROL G. 

The KIM-1 was first programmed to send 
code by Pollock [3], and some of the 
features of his program are found here. 
Pollock [4] has also described a micro- 
processor controlled keyboard using the 
6504. It has more features than his 
original program written for the KIM-1, 
but the program described here has some 
additional features which are very at- 
tractive, especially the receive pro- 
gram. 

II . BACKGROUND 

A. Sending Morse Code (ASCII to Morse) 

A negative going 10 microsecond strobe 
pulse from the keyboard is connected to 
the NMI pin on the KIM-1. Whenever a 
key is pressed an NMI interrupt occurs 
and the ASCII code from the keyboard is 
read at the lowest 7 pins of port A 
(PAD). The eighth bit is held high, so 
the number read is actually the ASCII 
code plus 80 hex. This number is 
stored in the FIFO buffer which is page 
2 of memory on the KIM-1. The send 
routine uses the numbers in the FIFO 
memory to index a location in page zero 
which contains the information to con- 
struct the Morse character. 

An illustration will make this clear. 
The ASCII hex representation of the 
letter C is 43- The strobe pulse 
causes port A to be read, which results 
in the number C3 (C3 = 43 + 80) being 
stored in the FIFO. When the send rou- 
tine gets to the location in the FIFO 
where C3 is stored, it uses it to 
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locate the contents of address 00C3- 
In location C3 in zero page is found 1A 
which is 00011010 in binary. The most 
significant 1 is simply a bit which in- 
dicates that all lesser significant 
bits contain the code information, 
namely 1 = dash and = dot. Thus, C 
is dash-dot-dash-dot (1010). 

The program causes the 00011010 to be 
rotated left (ROD until a 1 appears in 
the carry position. The carry flag set 
causes the program to analyze the re- 
maining bits for their code content. 
It does this by successively rotating 
them (ROD into the carry position. If 
a 1 appears in the carry position, PBC 
is held at logical 1 for the appropri- 
ate time followed by a space while PB0 
is at logical 0. If a appears in the 
carry position a dot is sent, followed 
by a space. When a total of 8 R0L com- 
mands have been completed, counting 
those needed to find the leading 1 , 
then PB0 is held at logical for an 
additional time to give a character 
space. The space bar produces still 
more time at logical to produce a 
word space . 

CONTROL S changes the NMI interrupt 
vectors so that the next two characters 
(hopefully decimal digits) from the 
keyboard are read, converted from base 
ten to hex [5], and converted to the 
basic time unit (see below). The in- 
terrupt vectors are then restored so 
that further characters from the key- 
board are read as usual . Control char- 
acters are obtained by pressing the 
control key followed by the appropriate 
control character. 

B. Timing Considerations. 

Before going much further, the timing 
calculations will be described. Morse 
code is a variable length code. That 
is, the number of bits is variable as 
contrasted to a fixed bit-length code 
such as ASCII. Its structure is based 
on the time duration of the various 
components as follows : 

Mark Elements : 

Dot = 1t 
Dash = 3t 



Space Elements 

Element space = 1t 

(time between dots and dashes) 
Character space = 3t 

(time between letters) 
Word space = 7t 

(time between words) 

The time t depends on the code speed. 
According to The Radio Amateur's Hand- 
book a code speed of ?4 words per min- 
ute (wpm) corresponds to 10 dots per 
second. Since there are 10 element 
spaces included in the 10 dots per sec- 
ond, there are a total of 20 t in one 
second: that is, t = 1/20 second at 24 
wpm. At any other speed then 

t = (1/20K24/S) 
= (50 ms)(24/S) 
= (1200/S) in milliseconds (ms) 

where S is the code speed in wpm. If 
the divide-by-1024 timer on the KIM is 
used, 1 count corresponds to 1.024 ms. 
The number T (called TIME in the pro- 
gram) to be loaded into the timer is 
then 

T = (1172/S) base ten or 
= (494/S) hex. 

The speed S in wpm is entered in deci- 
mal from the keyboard, converted to 
base 16 (hex), sent to a divide routine 
to find T, and T is stored at 0000 in 
memory. 99 wpm gives 0C hex in TIME 
while 05 wpm gives EB hex. Care was 
taken in developing the above calcula- 
tions because of a discrepancy between 
it and the results given by Pollock[4]. 

The system timing was tested by compar- 
ing it with code sent by W1AW. The 
speeds are the same to better than one 
word per minute from 5 wpm to 35 wpm. 

In the receiving program a word space 
is detected when a space counter ex- 
ceeds 5T. At moderate code speeds 5T 
is greater than 255 resulting in an 
overflow. Consequently, in the receive 
program 1/2T is used as the basic time 
unit. In this case, speeds as low as 
12 wpm can be received. At slower 
speeds the system still works, but word 
spaces occur between each letter. 
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C. Receiving Morse Code (Morse to 
ASCII ) 

To receive Morse code and convert it to 
ASCII, the inverse of the above process 
is carried out. It is assumed that a 
suitable audio detection circuit [1,2[ 
produces a logical 1 for a space ele- 
ment and a logical for a mark ele- 
ment. This digital Morse signal is ap- 
plied to PB7 and the IRQ pin on the 
KIM-1. A character register begins 
with a 1 in the zero bit position. 
Each time a dot is received the charac- 
ter register is shifted left and a zero 
is loaded into the character register. 
Each time a dash is received the char- 
acter register is shifted left and a 
one is loaded into the zero bit posi- 
tion. Thus, when a character space is 
detected, and a C (for example) has 
been received, the character register 
will contain 1A, just as in sending a 
C. However, the 1A is used to index a 
zero page location which contains the 
ASCII code for C, namely 43. The vari- 
ous components are identified by timing 
their duration. 

III. THE PROGRAMS 

A detailed listing of the programs is 
given below. The detailed comments 
should allow the reader to understand, 
modify, and trouble-shoot the program. 

A. The Send Program 

Some important variables, their mean- 
ings, and their locations in zero page 
are given: 



Name 



Location Use 



TIME 0000 TIME is the quantity T 
mentioned in the section on timing con- 
siderations. It is the time, in units 
of 1.024 ms, of the dot or element 
space components. 

SPEED 0013 SPEED is the hex equi- 
valent of the number entered for the 
speed by the operator. 

PNTR 0015 PNTR is a number which 
points to the location in the FIFO mem- 
ory which contains the character cur- 
rently being sent. The program idles 
as long as Y = PNTR, but begins to send 
when Y exceeds PNTR. 



Name Location Use 

L0 00 1E Scratchpad location 
for division of 494 by SPEED to give 
TIME. 



HI 



001F 



Same use as L0. 



CNTR 0022 CNTR keeps track of 
how many characters are left in the 
FIFO memory. A character entered de- 
crements CNTR; a character sent incre- 
ments CNTR. 

CHEK 0024 Scratchpad location to 
count the number of numbers which have 
been entered after the control S has 
been entered. 

YREG 00F4 The Y register is used 
to point to the location in the FIFO 
memory where the last character entered 
from the keyboard is, namely 0200, Y. 

B. The Receive Program 

Some important variables, their mean- 
ings, and their locations are given: 



Name 



Location Use 



XREG 00F5 The X register is the 
character register. It begins with a 1 
in the 0-bit. It is shifted left for 
each mark element received and loaded 
with a 1 for a dash and a zero for a 
dot. Later it is used to index a table 
in zero page which has the ASCII code 
for the character. 

MCNTZ 0054 If a mark element (dot 
or dash) is being received (PB7 and IRQ 
at logical 0) the mark counter is in- 
cremented at a rate of 1 count every 
2.048 ms. 

SCNTZ 00EE Same as mark counter 
except the incrementing occurs when a 
space is being detected (PB7 high and 
IRQ high) . Rate is also 1 count every 
2.048 ms. 

HALFT 0051 If the SPEED is set 
correctly, the number of counts during 
a dot should be exactly 1/2 TIME. This 
is the "dot length". If MCNTZ exceeds 
1/2 the dot length the program decides 
that a valid mark character has been 
received. HALFT is 1/2 the dot length. 
A valid space element occurs when SCNTZ 
exceeds HALFT. 
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Name Location Use 

TWOT 0052 TWOT is twice the dot 
length and is used to decide if a dot 
or a dash has been received. If MCNTZ 
exceeds TWOT the element is a dash, 
otherwise it is a dot. 

FIVET 0053 FIVET is five times 
the dot length and is used to decide 
when a word space has been received. 

IV. INTERFACE 

The keyboard strobe is connected to the 
NMI pin on the expansion connector on 
the KIM-1, and the 7 bit ASCII code 
from the keyboard goes to pins PA0-PA6, 
the low order bit to PAO and the high 
order bit to PA6. PA7 should be pulled 
up with a 10K resistor. 

The author's transmitter is a solid- 
state Triton IV and can be keyed with 
TTL IC's. The circuit diagram below 
indicates how it was connected to the 
KIM-1 . Transmitters using grid-block 
keying or cathode keying cannot use 
this circuit. A relay driven by a Dar- 
lington pair connected to pin PBO 
should work. The KIM-1 manuals give 
the appropriate details. 



+5 


V 


1 


14 












2 


k 


JUO0 W 3 | 




/To Xmtr 


^^* 






From PBO 


GN1 





The audio from the receiver must pro- 
duce a logical at pin PB7 and the IRQ 
pin when a tone is detected, and a log- 
ical 1 at the same pins when a space is 
detected. The reader is urged to try 
either of the circuits found in refer- 
ences 1 and 2. I used a half-baked 
scheme in which the audio from the re- 
ceiver was fed to a half-wave recti- 
fier (diode), filtered slightly, and 
connected to the inverting input of a 
CA3140 op amp. The voltage at the non- 
inverting input was adjustable. The op 



amp was operated as an open-loop com- 
parator with the output connected to 
pin PB7 and IRQ. An oscilloscope was 
necessary to monitor the output and 
make the necessary adjustments for var- 
ious signal levels. I am not recom- 
mending this circuit for general use. 

I have also tried using the tape-input 
PLL system on the KIM-1 to convert the 
receiver audio to a digital signal. To 
lower the free-running frequency of the 
VCO a shunt capacitor must be added. 
The digital signal appears at address 
1742, bit 7- I had only marginal suc- 
cess, the problem being that the digi- 
tal signal tends to drop out for very 
short periods of time , which clears the 
mark counter (instructions 039F-03A2) . 
Substituting NOP's for these instruc- 
tions seems to improve the performance, 
but receiver tuning and volume control 
adjustments are sensitive. Some users 
may wish to experiment with deleting 
the aforementioned instructions in 
whatever interface circuit they may 
use. 



V. MISCELLANEOUS REMARKS 

To get the entire Send/ Receive program 
in the KIM-1 memory extensive use was 
made of page 1 . This is also used as 
the stack. Care was taken to leave 
enough room for the stack operations, 
and for insurance, there are several 
points in the program where the stack 
pointer is initialized to FF. No prob- 
lems should be encountered once the 
program is up and running. If you have 
any debugging to do I suggest using the 
single-step mode (be sure to set the 
NMI vectors) to check the jumps and 
branches. My experience has been that 
errors in branches generally result in 
about half the program being wiped out , 
especially if it is in page 1 of 
memory . 

Wouldn't it be nice if some outfit like 
The COMPUTERIST would offer an inter- 
face board which would provide an audio 
to digital Morse circuit, a relay 
driver and relay (reed type) for trans- 
mit, a DIP socket for a ribbon cable 
from the keyboard, and a DIP socket for 
the ASP.TT out (see appendix), all on a 
single board which would mate with the 
KIM-1 application socket. 

The first time I operated the system, I 
answered a CQ on 40 meters from WB2GMN, 
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Hank, who has Army Signal Corps exper- 
ience. Even though he rated his speed 
at 55 wpm he copied me at 60 wpm. Hank 
reported that the code sounded like 
perfect code (which it should be) and 
that it was very crisp at 60 wpm. It 
was a real coincidence to contact some- 
one who had the capability to appreci- 
ate the keyboard system and to give an 
evaluation of its performance. 

I hope that you enjoy working these 
programs. If you do not want the re- 
ceive program, simply put in a JMP 0300 
instruction (4C 00 03) starting at 
0300. If you have any questions, feel 
free to write , end nsing a SASE for a 
response. I will try to answer any 
questions about interfacing the system 
to your station. 
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ACSII to MORSE and MORSE to ASCII 
Lookup Tables in Page Zero 



00 XX 20 45 54 49 41 4E 4D 53 55 52 57 44 4B 47 4F 

10 48 56 46 XX 4C XX 50 4A 42 58 43 59 5A 51 XX XX 

20 35 34 XX 33 XX XX XX 32 XX XX XX XX XX XX XX 31 

30 36 3D 2F XX XX XX XX XX 37 XX XX XX 38 XX 39 30 

40 XX XX XX XX XX XX XX XX XX XX XX XX 3F XX XX XX 

50 XX XX XX XX XX 2E XX XX XX XX XX XX XX XX XX XX 

A0 80 XX XX 2A 45 XX XX XX XX XX XX XX 73 XX 55 32 

B0 3F 2F 27 23 21 20 30 38 3C 3E XX XX XX 31 XX 4C 

CO XX 05 18 1A 0C 02 12 0E 10 04 17 0D 14 07 06 OF 

DO 16 1D 0A 08 03 09 11 0B 19 1B 1C XX XX XX XX XX 



Special Morse Characters 



Keyboard Character 



BT 

SK 

AR 
Space (Word) 



$ 

# 

Space Bar 
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0056 



TIME 


• 


$0000 


ZTB 


* 


$0000 


SPEED 


« 


$0013 


PNTR 


* 


$0015 


L0 


« 


$001E 


HI 


« 


$001F 


CNTR 


* 


$0022 


CHEK 


* 


$0024 


HALFT 


» 


$0051 


TWOT 


« 


$0052 


FIVET 


* 


$0053 


MCNTZ 


* 


$0054 


SCNTZ 


* 


$00EE 


FIFO 


« 


$0200 


CULO 


* 


$13F9 


CUHI 


* 


$13FA 


DATA 


* 


$13FB 


NMIL 


* 


$17FA 


NMIH 


* 


$17FB 


IRLO 


* 


$17FE 


IRHI 


* 


$17FF 


PAD 


* 


$1700 


PADD 


* 


$1701 


PBD 


* 


$1702 


PBDD 


» 


$1703 


SAD 


» 


$1740 


SADD 


« 


$1741 


SBD 


• 


$1742 


SBDD 


* 


$1743 


TIM 


« 


$1706 


TMER 


• 


$1707 


TAB 


« 


$1FE7 



MORSE CODE SEND PROGRAM 



ORG $0056 



0056 D8 




INIT 


CLD 


0057 A9 


40 




LDAIM $40 


0059 85 


00 




STAZ TIME 


005B 78 




RTN 


SEI 


005C A2 


FF 




LDXIM $FF 


005E 9A 






TXS 


005F A9 


20 




LDAIM VCTL 


0061 8D 


FA 


17 


STA NMIL 


0064 A9 


01 




LDAIM VCTL 


0066 8D 


FB 


17 


STA NMIH 


0069 A9 


00 




LDAIM $00 


006B 8D 


01 


17 


STA PADD 


006E 8D 


02 


17 


STA PBD 


0071 A9 


01 




LDAIM $01 


0073 8D 


03 


17 


STA PBDD 


0076 A9 


7F 




LDAIM $7F 


0078 8D 


41 


17 


STA SADD 


007B A9 


1E 




LDAIM $1E 


007D 8D 


43 


17 


STA SBDD 


0080 A9 


08 




LDAIM $08 



1/2 DOT TIME 
TWICE DOT TIME 
FIVE TIME DOT TIME 



AUTHORS DISPLAY DEVICE 
REGISTERS 

NON-MASKABLE INTERRUPT LOW 

NON-MASKABLE INTERRUPT HIGH 

INTERRUPT REQUEST LOW 

INTERRUPT REQUEST HIGH 

PORT A DATA 

PORT A DATA DIRECTION 

PORT B DATA REGISTER 

PORT B DATA DIRECTION REGISTER 

KIM DISPLAY 

KIM DISPLAY DIRECTION 



DIVIDE BY 64 TIMER 
DIVIDE BY 1024 TIMER 
KIM ROM CHARACTER TABLE 



INIT SEQUENCE. CLEAR DECIMAL 

INITIAL CODE SPEED OF 18 WPM 

PREVENT INTERRUPTS 

FROM RECEIVER 

SET STACK POINT TO TOP $01 FF 

SET NIM VECTORS FOR KEYBOARD 



/ 



PORT A IS INPUT PORT 

PORT B, PIN PBO, WILL BEGIN AT 

PORT B, PIN PBO, IS OUTPUT PIN 

SET UP DISPLAY PORTS 

PINS 0-6 ARE OUTPUT PINS 

PINS 1 - 4 ARE OUTPUT PINS 
INIT LEFTMOST DIGIT 
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0082 8D 42 17 
0085 A9 80 
0087 8D 40 17 
008A A0 FF 
008C 84 15 
008E 84 22 
0090 C4 15 
0092 FO FC 
0094 E6 15 
0096 A6 15 
0098 BD 00 02 
009B 4C 15 01 



LOOP 



STA 


SBD 


LDAIM 


$80 


STA 


SAD 


LDYIM $FF 


STYZ 


PNTR 


STYZ 


CNTR 


CPYZ 


PNTR 


BEQ 


LOOP 


INCZ 


PNTR 


LDXZ 


PNTR 


LDAX 


FIFO 


JMP 


LOOPX 



ON KIM-1 DISPLAY 

BLANK DISPLAY BY PUTTING 80 

IN PORT SAD 

INIT Y POINTER 

INIT SEND POINTER 

INIT BUFFER COUNTER 

IS Y = PNTR? 

YES, IDLE UNTIL DIFFERENT 

NO, INCR PNTR TO LOOKUP 

CHARACTER. PNTR = X INDEX 

GET CHARACTER FROM FIFO 

CONTINUE AT LOOPX 



DISPLAY SUBROUTINE 



0100 



0100 A6 22 




0102 EO 10 




0104 90 08 




0106 A9 80 




0108 8D 40 


17 


010B 4C 14 


01 


010E BD E7 


1F 


0111 8D 40 


17 


0114 60 




0115 20 80 


17 


0118 E6 22 




011A 20 00 


01 


011D 4C 90 


00 



DISP 



OVER 



THER 



LOOPX 



ORG 


$0100 




LDXZ 


CNTR 


TRANSFER CNTR TO X 


CPXIM $10 


IS CNTR LESS THAN 10 HEX 


BCC 


OVER 


YES, DISPLAY CNTR 


LDAIM $80 


NO, BLANK DISPLAY 


STA 


SAD 




JMP 


THER 




LDAX 


TAB 


FIND VALUE. FROM KIM ROM 


STA 


SAD 


TO DISPLAY CNTR 


RTS 




RETURN 


JSR 


SEND 


GO TO SEND TO OUTPUT CODE 


INCZ 


CNTR 


INCR CNTR 


JSR 


DISP 


DISPLAY IF LESS THAN 10 


JMP 


LOOP 


CONTINUE LOOP 



INTERRUPT ROUTINES 



0120 


48 






VCTL 


PHA 




0121 


8A 








TXA 




0122 


48 








PHA 




0123 


08 








PHP 




0124 


AD 


00 


17 




LDA 


PAD 


0127 


48 








PHA 




0128 


29 


60 






ANDIM $60 


012A 


FO 


OF 






BEQ 


CNTRL 


012C 


68 








PLA 




012D 


C8 








INY 




012E 


99 


00 


02 




STAY 


FIFO 


0131 


20 


00 


01 




JSR 


DISP 


0134 


C6 


22 






DECZ 


CNTR 


0136 


28 






BACK 


PLP 




0137 


68 








PLA 




0138 


AA 








TAX 




0139 


68 








PLA 




013A 


40 








RTI 




013B 


68 






CNTRL 


PLA 




013C 


29 


7F 






ANDIM $7F 


013E 


C9 


02 






CMPIM $02 



SAVE A, X AND STATUS 
ON STACK 



READ KEYBOARD 

SAVE ON STACK 

MASK ALL BUT TOP BITS 

CONTROL CHARACTER? 

NO. RECALL A AND INCR Y 

STORE A CHAR IN FIFO 
DISPLAY CNTR IF LESS THAN 10 
UPDATE CNTR 
RESTORE REGISTER 



RETURN FROM INTERRUPT 

RECALL A FROM STACK 
MAKS OFF HIGHEST BIT 
BACKSPACE? 
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0140 DO 


06 


BNE 


CNTX 


TEST OTHER CHARACTER 


0142 88 




DEY 




YES. DECR Y TO DELETE CHARACTER 


0143 E6 


22 


INCZ 


CNTR 


FIX COUNTER 


0145 4C 


36 01 


JMP 


BACK 


RETURN 


0148 C9 


1 3 CNTX CMPIM 


$13 


CONTROL S = SPEED 


014A DO 


58 


BNE 


ARND 


NO TEST OTHERS 


014C A9 


58 


LDAIM 


FIX 


CHANGE INTERRUPT SO NEXT 


014E 8D 


FA 17 


STA 


NMIL 


INTERRUPTS GO TO FIX 


0151 A9 


00 


LDAIM 


$00 


INIT CHEK TO 00 


0153 85 


24 


STAZ 


CHEK 




0155 4C 


36 01 


JMP 


BACK 


RETURN 


0158 48 


FIX PHA 




SAVE REGISTERS 


0159 8A 




TXA 






015A 48 




PHA 






015B 08 




PHP 






015C AD 


00 17 


LDA 


PAD 


READ FIRST DIGIT 


015F 29 


OF 


ANDIM $0F 


MASK TO DIGIT 


0161 AA 




TAX 




MOVE TO X 


0162 A5 


24 


LDAZ 


CHEK 


CHEK = = FIRST DIGIT 


0164 C9 


01 


CMPIM 


$01 


CHEK = 1 = SECOND DIGIT 


0166 FO 


10 


BEQ 


AHD 


FIRST DIGIT BRANCH 


0168 8A 




TXA 




GET DIGIT BACK 


0169 OA 




ASLA 




TIMES 2 


016A 85 


13 


STAZ 


SPEED 


SAVE 


016C OA 




ASLA 




TIMES 4 


01 6D OA 




ASLA 




TIMES 8 


016E 18 




CLC 




PREPARE TO ADD SPEED 


016F 65 


13 


ADCZ 


SPEED 


*8 + *2 = *10 


0171 85 


13 


STAZ 


SPEED 


STORE 


0173 E6 


24 


INCZ 


CHEK 


SET FOR SECOND DIGIT 


0175 4C 


36 01 


JMP 


BACK 


RETURN 


0178 C6 


24 AHD DECZ 


CHEK 


RE-INIT CHEK 


017A 8A 




TXA 






017B 18 




CLC 






017C 65 


13 


ADCZ 


SPEED 


ADD ONES DIGIT TO 


017E 85 


13 


STAZ 


SPEED 


TENS DIGIT ANS STORE 


0180 38 




SEC 




DIVIDE 494(HEX)/SPEED 


0181 A2 


00 


LDXIM 


$00 


CLEAR X FOR QUOTIENT 


0183 A9 


94 


LDAIM 


$94 


LOW ORDER BYTE OF DIVIDEND 


0185 85 


1E 


STAZ 


LO 




0187 A9 


04 


LDAIM 


$04 


HIGH ORDER BYTE OF DIVIDEND 


0189 85 


1F 


STAZ 


HI 




018B A5 


1E UP 


LDAZ 


LO 


START SUB. FROM DIVIDEND 


018D E5 


13 


SBCZ 


SPEED 


UNTIL BORROW 


018F 85 


1E 


STAZ 


LO 


FROM HIG BYTE, IE CARRY IS SET 


0191 A5 


1F 


LDAZ 


HI 


IF BORROW OCCURS FROM LOW ORDER 


0193 E9 


00 


SBCIM 


$00 


BYTE, SUB 1 FROM HIGH 


0195 85 


1F 


STAZ 


HI 


ORDER BYTE 


0197 E8 




INX 




INCR X FOR EACH SUB. 


0198 BO 


F1 


BCS 


UP 


BORROW FROM HI? NO. GO BACK 


019A 86 


00 


STXZ 


TIME 


AND SUB. OTHERWISE DONE 


019C A9 


20 


LDAIM 


VCTL 


RESET NMI VECTORS FOR VCTL 


019E 8D 


FA 17 


STA 


NMIL 
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01A1 4C 


36 


01 




JMP 


BACK 


RETURN TO MAIN PROGRAM 


01A4 C9 


12 




ARND 


CMPIM 


$12 


REMAINDER OF VCTL 


01A6 DO 


03 






BNE 


TREE 


CONTROL R? 


01A8 4C 


00 


03 




JMP 


RCV 


YES. GO TO RECEIVE PROGRAM 


01AB C9 


OD 




TREE 


CMPIM 


$0D 


CARRAIGE RETURN? 


(HAD DO 


03 






BNE 


BUF 


BRANCH IF NOT 


01AF 4C 


5B 


00 




JMP 


RTN 


YES. START MAIN PROGRAM 


01B2 C9 


07 




BUF 


CMPIM 


$07 


CONTROL G? 


01B4 FO 


03 






BEQ 


BRR 


YES. RESET STACK POINTER AND 


01B6 4C 


B6 


01 


IDLE 


JMP 


IDLE 


TO LOOP. OR, IDLE HERE 


01B9 A2 


FF 




BRR 


LDXIM 


$FF 


WHILE BUFFER IS LOADED 


OIBB 9A 








TXS 




RESET STACK TOP 


01BC 4C 


90 


00 




JMP 


LOOP 


AND CONTINUE 



MORSE CODE RECEIVE PROGRAM 













ORG 


$0300 




0300 


A9 


90 




RCV 


LDAIM 


IRQ 


SET IRQ VECTORS 


0302 


8D 


FE 


17 




STA 


IRLO 




0305 


A9 


03 






LDAIM 


IRQ 


/ PAGE ADDRESS 


0307 


8D 


FF 


17 




STA 


IRHI 




030A 


A5 


00 




CRK 


LDAZ 


TIME 


SET DOT LENGTH BY GETTING 


030c 


4A 








LSRA 




TIME AND DIVIDING BY 2 


030D 


85 


51 






STAZ 


HALFT 




030F 


46 


51 






LSRZ 


HALFT 


HALFT HALFT IS 1/2 DOT LENGTH 


0311 


85 


52 






STAZ 


TWOT 




0313 


06 


52 






ASLZ 


TWOT 


TWOT IS TWICE DOT LENGTH 


0315 


85 


53 






STAZ 


FIVET 




0317 


OA 








ASLA 




MULTIPLY BY 4 


0318 OA 








ASLA 






0319 


18 








CLC 






031A 


65 


53 






ADCZ 


FIVET 


AND ADD 1 TIMES TO GET 


031C 


85 


53 






STAZ 


FIVET 


5 TIMES DOT LENGTH 


031E 


A9 


00 






LDAIM 


$00 


CLEAR MARK AND SPACE 


0320 


85 


54 






STAZ 


MCNTZ 


COUNTERS 


0322 


85 


EE 






STAZ 


SCNTZ 




0324 


58 








CLI 




ALLOW INTERRUPTS TO START 


0325 


A2 


01 






LDXIM $01 


INIT CHARACTER REGISTER 


0327 


4C 


27 


03 


IDL 


JMP 


IDL 


IDLE HER UNTIL MARK OCCURS 


032A 


20 


8A 


03 


AGN 


JSR 


TIMSET 


START TIMER FOR SPACE COUNT 


032D 


E6 


EE 






INCZ 


SCNTZ 


INCR SPACE COUNTER 


032F 


A5 


EE 






LDAZ 


SCNTZ 


DOES IT EXCEED 1/2 DOT LENGTH 


0331 


C5 


51 






CMPZ 


HALFT 




0333 


BO 


08 






BCS 


CHECK 


YES, JUMP TO SET CHAR REGS 


0335 


AD 


07 


17 


WAIT 


LDA 


TMER 


OTHERWISE WAIT FOR TIMER 


0338 


10 


FB 






BPL 


WAIT 




033A 


4C 


2A 


03 




JMP 


AGN 


AND COUNT SPACES 


033D 


8A 






CHECK 


TXA 




SHIFT CHAR REGISTER LEFT 


033E 


OA 








ASLA 






033F 


AA 








TAX 
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0340 A5 54 LDAZ MCNTZ IF MARK COUNTER EXCEEDS TWICE 

0342 C5 52 CMPZ TWOT THE DOT LENGTH, PUT ONE IN 

0344 90 03 BCC SKIP CHAR REGISTER, OTHERWISE A ZERO 

0346 E8 INX 

0347 BO 11 BCS FAT IF A DASH, SKIP DISPLAY 

0349 OA SKIP ASLA IF A DOT, COMPARE WITH TIME 
034A C5 00 CMPZ TIME FOR SPEED INDICATOR 

034C BO 07 BCS CAT 

034E A9 F1 LDAIM $F1 SHOW "F" IS DISPLAY 

0350 8D 40 17 STA SAD 
0353 90 05 BCC FAT 

0355 A9 ED CAT LDAIM $ED SHOW "S" IN DISPLAY 

0357 8D 40 17 STA SAD 

035A A9 00 FAT LDAIM $00 CLEAR MARK COUNTER 

035C 85 54 STAZ MCNTZ 

035E AD 07 17 HOLD LDA TMER WAIT FOR TIMER 

0361 10 FB BPL HOLD 

0363 20 8A 03 JSR TIMSET START TIMER AGAIN 

0366 E6 EE INCZ SCNTZ INCR SPACE COUNTER AGAIN 

0368 A5 EE LDAZ SCNTZ 

036A C5 52 CMPZ TWOT DOES SPACE COUNTER EXCEED TWICE 

036C 90 FO BCC HOLD THE DOT LENGTH. IF NOT, HOLD 

036E 20 CA 03 JSR CHAR IF YES, PRINT CHARACTER 

0371 A2 01 LDXIM $01 RESET CHAR REGISTER 

0373 AD 07 17 DOZE LDA TMER WAIT FOR TIMER 

0376 10 FB BPL DOZE 

0378 20 8A 03 JSR TIMSET START TIMER AGAIN 

037B E6 EE INCZ SCNTZ INCR SPACE COUNTER 

037D A5 EE LDAZ SCNTZ 

037F C5 53 CMPZ FIVET DOES SPACE COUNTER EXCEED FIVE TIMES 

0381 90 FO BCC DOZE DOT LENGTH. IF LESS, DOZE AGAIN 

0383 20 CA 03 JSR CHAR OTHERWISE PRINT SPACE 

0386 78 SEI PREVENT INTERRUPTS WHILE 

0387 4C OA 03 JMP CRK CHECKING SPEED SETTING 

038A A9 20 TIMSET LDAIM $20 LOAD TIMER FOR 2.048 MS 

038C 8D 06 17 STA TIM 

038F 60 RTS RETURN TO RCV PROGRAM 

0390 08 IRQ PHP SAVE REGISTERS 

0391 48 PHA 

0392 20 8A 03 JSR TIMSET START TIMER 

0395 AD 07 17 LOAF LDA TMER WAIT FOR TIMER 

0398 10 FB BPL LOAF 

039A AD 02 17 LDA PBD IS MARK SIGNAL PRESENT 

039D 10 09 BPL OVER YES, GO TO OVER 

039F A9 00 LDAIM $00 NO, MUST HAVE BEEN NOISE 

03A1 85 54 STAZ MCNTZ WHICH CAUSED INTERRUPT. RETURN 

03A3 E6 EE INCZ SCNTZ TO COUNT SPACE AFTER RESETTING 

03A5 68 PLA MARK COUNTER TO ZERO 

03A6 28 PLP 

03A7 40 RTI RETURN FROM INTERRUPT 
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03A8 
03AB 
03AD 
03AF 
03B1 
03B3 
03B5 
03B7 
03BA 
03BC 
03BF 
03C1 
03C2 
03C4 
03C5 
03C6 
03C7 



03CA B5 00 
03CC 8D FB 
03CF A9 3F 
03D1 2D F9 
3F 
11 
1F 



20 8A 03 

E6 54 

A5 54 

C5 51 

90 E2 

A9 00 

85 EE 

AD 07 17 

10 FB 

AD 02 17 

10 E7 

8A 

A2 FF 

9A 

AA 

58 

4C 2A 03 



13 



13 



03D4 C9 
03D6 90 
03D8 A9 
03DA 2D FA 13 
03DD 18 
03DE 69 01 
03E0 C9 20 
03E2 90 02 
03E4 A9 10 
03E6 8D FA 13 
03E9 EE F9 13 
03EC 60 



OVER JSR 
INCZ 
LDAZ 
CMPZ 
BCC 
LDAIM 
STAZ 

KILTIM LDA 
BPL 
LDA 
BPL 
TXA 
LDXIM 
TXS 
TAX 
CLI 
JMP 



CHAR 



UP 
AHD 



LDAZX 

STA 

LDAIM 

AND 

CMPIM 

BCC 

LDAIM 

AND 

CLC 

ADCIM 

CMPIM 

BCC 

LDAIM 

STA 

INC 

RTS 



TIMSET 

MCNTZ 

MCNTZ 

HALFT 

LOAF 

$00 

SCNTZ 

TMER 

KILTIM 

PBD 

OVER 

$FF 



AGN 

ZTB 

DATA 

$3F 

CULO 

$3F 

AHD 

$1F 

CUHI 

$01 

$20 

UP 

$10 

CUHI 

CULO 



START TIMER AGAIN 

INCR MARK COUNTER 

DOES MARK COUNTER EXCEED 

1/2 THE DOT LENGTH? 

NO, GO LOAF AND CHECK MARK 

YES. CLEAR SPACE COUNTER 

CHECK TIMER 

KILL TIME 

CHECK MARK SIGNAL ON PB7 

LOOP AGAIN IF STILL ON 

SAVE S WHILE STACK POINTER IS SET 

RESET TO TOP OF STACK 

RESTORE X 

CLEAR INTERRUPT FLAG SET EARLIER 

RETURN TO COUNT SPACE 

LOOKUP ASCII SYMBOL 
DATA IS VIDEO PORT IN AUTHORS 
SYSTEM. THE REMAINDER OF THIS 
SUBROUTINE INCREMENTS THE 
POSITION OF THE CURSOR TO PREPARE 
FOR THE NEXT CHARACTER 



SEND SUBROUTINE 



1780 

1780 AA SEND 

1781 B5 00 
1783 30 3F 

1785 18 

1786 A2 08 

1788 2A RPT 

1789 BO 06 
178B CA 
178C FO 35 
178E 4C 88 17 

1791 CA DWN 

1792 2A BACK 

1793 48 

1794 8A 

1795 48 



ORG $1780 

TAX 

LDAZX ZTB 
BMI WDSP 
CLC 

LDXIM $08 
ROLA 



BCS 

DEX 

BEQ 

JMP 

DEX 

ROLA 

PHA 

TXA 

PHA 



DWN 

OUT 
RPT 



A CONTAINS CHAR FROM FIFO 

USE THIS TO LOOKUP MORSE 

SPACE BAR CHAR HAS 1 IN BIT 7 

IF NOT MINUS, CLEAR CARRY FLAG AND 

SET UP X FOR 8 ROL INSTRUCTIONS 

ROTATE LEFT UNTIL 1 APPEARS IN CARRY 

BRANCH IF 1 IN CARRY 

ELSE, DECREMENT X 

IF X = 0, THEN DONE 

ELSE CONTINUE 

KEEP TRACK OF BITS TESTED 

ROTATE A LEFT AND SAVE ON STACK 

SAVE X ON STACK ALSO 
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1796 BO 


18 






BCS 


DASH 


1798 A2 


01 






LDXIM $01 


179 A EE 


02 


17 


DAH 


INC 


PBD 


179D 20 


C9 


17 


SPA 


JSR 


TIMER 


17A0 CA 








DEX 




17A1 DO 


FA 






BNE 


SPA 


17A3 AD 


02 


17 




LDA 


PBD 


17A6 4A 








LSRA 




17A7 90 


OC 






BCC 


DONE 


17A9 CE 


02 


17 




DEC 


PBD 


17AC E8 








INX 




17 AD 4C 


9D 


17 




JMP 


SPA 


17B0 A2 


03 




DASH 


LDXIM $03 


17B2 4C 


9A 


17 




JMP 


DAH 


17B5 68 






DONE 


PLA 




17B6 AA 








TAX 




17B7 68 








PLA 




17B8 CA 








DEX 




17B9 DO 


D7 






BNE 


BACK 


17BB A2 


02 






LDXIM 


$02 


17BD 20 


C9 


17 


AGAIN 


JSR 


TIMER 


17C0 CA 








DEX 




17C1 DO 


FA 






BNE 


AGAIN 


17C3 60 






OUT 


RTS 




17C4 A2 


04 




WDSP 


LDXIM 


$04 


17C6 4C 


BD 


17 




JMP 


AGAIN 


17C9 A5 


00 




TIMER 


LDAZ 


TIME 


17CB 8D 


07 


17 




STA 


TMER 


17CE 2C 


07 


17 


CHK 


BIT 


TMER 


17D1 10 


FB 






BPL 


CHK 


17D3 60 








RTS 





DID ROTATE SET CARRY? IF YES, 

SEND DASH, ELSE SEND DOT 

PBO WILL BE LOGICAL 1 FO 1 T 

TIME GIVES DELAY OF TIME (1.024MS) 

ONE TIME UNIT IS UP 

IS X = 0? DELAY ANOTHER UNIT 

YES. NOW CHECK PBO. IF A 1 

A SHIFT WILL SET CARRY FLAG 

IF CARRY CLEAR, THEN DONE 

OTHERWISE, SET PBO = FOR ELEMENT 

SPACE FOR A DELAY OF 1 UNIT BY 

RESETTING X AND LOADING TIMER 

DASH TAKES 3 TIME UNITS 

SEND 3 UNITS FOLLOWED BY SPACE 

THEN ELEMENT IS DONE SO 

RESTORE A AND X AND GO BACK 

IF X IS NOT ZERO 

OTHERWISE ADD CHARACTER SPACE 

BY RUNNING TIMER FOR 

2 MORE TIME UNITS 



IF X = 0, THEN DONE 
OR ELSE DELAY MORE 

WORDSPACE REQUIRES 4 MORE TIME UNITS 
SO USE TIMER FOR THIS 

GET TIME FROM ZERO PAGE 
LOAD DIVIDE BY 1024 TIMER 
IS TIMER FINISHED? 
NO, WAIT FOR IT 
YES, RETURN 
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APPENDIX : 

Using the KIM-1 Ports to 

Output the ASCII 



Most readers will not have the same 
addressable video system used by the 
author. To use the receive portion of 
the program, some provision must be 
made to output the ASCII along with a 
strobe pulse. Below you will find a 
suggested program to do this. It makes 
use of ports SAD and SBD addresses 1740 



and 1742 respectively. These are 
available on the application connector. 
The ASCII code appears at the KB COL 
A-G pins, while the strobe should ap- 
pear at the TTY PTR pin. 

NOTE: While this program should work 
it has not been tested. 



ALTERNATIVE ASCII OUTPUT 











ORG 


$03CA 








*** THIS ROUTINE E 


03CA 






ZTB 


* 


$0000 


03CA 






SAD 


* 


$1740 


03CA 






SADD 


* 


$1741 


03CA 






SBD 


• 


$1742 


03CA 






SBDD 


• 


$1743 


03CA A9 


20 




CHAR 


LDAIM 


$20 


03CC 8D 


42 


17 




STA 


SBD 


03CF A9 


21 






LDAIM 


$21 


03D1 8D 


43 


17 




STA 


SBDD 


03D4 AD 


40 


17 




LDA 


SAD 


03D7 48 








PHA 




03D8 AD 


41 


17 




LDA 


SADD 


03DB 48 








PHA 




03DC B5 


00 






LDAZX 


ZTB 


03DE 8D 


40 


17 




STA 


SAD 


03E1 A9 


FF 






LDAIM 


$FF 


03E3 8D 


41 


17 




STA 


SADD 


03E6 EE 


42 


17 




INC 


SBD 


03E9 EA 








NOP 




03EA CE 


42 


17 




DEC 


SBD 


03ED 68 








PLA 




03EE 8D 


41 


17 




STA 


SADD 


03F1 68 








PLA 




03F2 8D 


40 


17 




STA 


SAD 


03F5 A9 


1E 






LDAIM $1E 


03F7 8D 


43 


17 




STA 


SBDD 


03FA A9 


08 






LDAIM 


$08 


03FC 8D 


42 


17 




STA 


SBD 


03FF 60 








RTS 





ENABLE OUTPUT PULSE PINS 



SAVE CONTENTS OF CURRENT 
DISPLAY ON KIM-1 



GET ASCII CODE 
OUTPUT ASCII 

ENABLE OUTPUT PORT 

STROBE PULSE WILL BE 

LENGTHEN PULSE 

NEGATIVE 

RESTORE SADD AND SAD 



RESTORE SBDD AND SBD 
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PET 



Commodore Business Machines , Inc . 

901 California Avenue 

Palo Alto, CA 94304 

415-326-4000 
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The PET's IEEE-488 Bus: Blessing or Curse? 53 

by Charles Floto, Editor of Buss and Yankee Bits and freelance 
writer and photographer whose work has appeared in Byte , 
Personal Computing , and Kilobaud 

Power from the PET 54 

by Karl E. Quosig 

PET Composite Video Output 55 

by Cal E. Merritt 

Design of a PET/TTY Interface 56 

by Charles R. Husbands 

The PET Vet Examines Some BASIC Idiosyncrasies 61 

by Charles Floto 



The PET Vet Tackles Data Files 
by Charles Floto 
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A Partial List of PET Scratch Pad Memory* 64A 

by Gary A. Creighton 

LIFE for Your PET 65 

by Dr. Frank H. Covitz 

A Simple 6502 Assembler for the PET 73 

by Michael J. McCann 

A BASIC 6502 Disassembler for APPLE and PET 78 

by Michael 3. McCann 



* a perforated "tear-out" reference card 
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THE PET'S IEEE-48B BUS: BLESSING OR CURSE? 

Charles Floto 

267 Willow Street 

New Haven, CT 06511 

Copyright 1977 by Charles Floto 



IEEE-488 (usually pronounced I-triple-E four- 
eighty-eight) is the number of a standard for 
information exchange adopted by the Institute of 
Electrical and Electronics Engineers. Given 
that a major complaint of microcomputer users 
has been that the lack of industry standards 
prevents the exchange of information, the react- 
ion when it was announced that Commodore's PET 
2001 would support the IEEE bus should perhaps 
not be surprising. 

However a few people have been surprised by this 
488 mania. Pickles & Trout accompanied announ- 
cement of an I/O board for the S-100 bus with 
with the offhand remark that they planned to 
produced a 488 adapter for it. When they found 
that enthusiasm for this incidental feature 
overwhelmed interest in the basic board they de- 
cided to develop an I/O card exclusively to sup- 
port the IEEE-488 bus. It is expected to retail 
in the $200 range. Which makes the fact that 
Commodore is including a similar interface in 
the $800 PET (8KRAM version) all the more won- 
derful. 

Just how easy will it be for a PET owner to 
design a system around the IEEE-488 bus? It can 
be compared to solving the following problem; 
You are to design a computer with provision for 
more than one CPU card. Its bus shall be limit- 
ed to 16 signal lines, with several ground lines 
but no power lines. You are to build a separate 
power supply for each card in the system and, 
since it is to be spread all over your home or 
office , a separate case as well . 

The difference between this problem and using 
the IEEE-488 bus is that in the latter case the 
design of the bus has been done for you and to 
use it you must be prepared to abide by certain 
specified and rather complex conventions. In 
short, you shouldn't even attempt to design a 
peripheral interface to the PET's 488 I/O bus 
unless you feel capable of designing internal 
circuit cards for other computers. Even then 
you may have problems if all your experience has 
been with a bus each of whose lines has a fixed 
purpose , rather than some being shared between 
data and either address or control functions. 



If the IEEE-488 bus presents such difficulty in 
designing peripherals, why would Commodore want 
to use it? The first thing to realize is that 
design represents a fixed cost , the same whether 
you build one unit or 100,000. While design 
cost per unit is absurdly exorbitant for the in- 
dividual making a single 488-compatible compon- 
ent, it becomes trivial for the mass producer. 

For a second consideration suppose you were put- 
ting together your own system and Pickles & 
Trout offered you a circuit card to link your 
computer to the IEEE bus for $200. That's a lot 
to pay for one 1/0 port, but it's a bargain if 
it's the only one you'll ever have to buy. Thus 
the IEEE-488 format makes the PET less expensive 
than including an impressive number of serial 
and parallel ports . 

Third, why expect PET to make things easy for 
individual hardware designers when that isn't 
the market it's aimed at? 

At this point perhaps it's worth noting that the 
PET is only claimed to be electrically and logi- 
cally compatible with the IEEE-488 bus—physical 
compatibiltiy is lacking as signals come out on 
printed circuit fingers rather than the standard 
connector. Standard interconnection cable con- 
sists of 16 signal lines, seven grounds, and a 
shield; it has male and female connections at 
each end. The corporate purchaser of a large 
system might pay as much for a single cable as 
the hobbyist pays for a circuit card. 

We can't really judge the value of the PET's 
IEEE-488 bus until we see what becomes available 
to connect to it, and at what price. For now 
we may conclude that it presents a problem to 
those who want to design their own peripherals, 
but the potential for a competitive market in 
sophisticated mass-produced peripherals which 
will "plug in and go" in a wide variety of sys- 
tems. And those who already own IEEE-488 
products will be able to add the PET's computer 
power at an unprecedented price. 
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POKER FROM THE PET 

Karl E. Quosiq 
2038 Hartnell Street 
Union City, CA 94587 



It is by now well known that the PET has no 
source of power for use outside of itself. The 
only source available is at the second Cassette 
Interface. This +5 VDC line will not source 
very much current; in fact, it will not even run 
a second cassette recorder. Also, all the +5 
VDC regulators inside the PET are already run- 

^ ng ,Si lte warm - If you want to experiment with 
the PET, say with the Parallel User Port (Mos 
Technology 6522 VIA), then where do you get the 
power without a complicated power supply inter- 
lace? The answer is simple. I found the fol- 
lowing inside the PET. One, the bridge recti- 
fier is good for 3 Amperes. Two, the PET draws 
1.5 Amperes worst case load. Conclusion: it 
15° U • Possible to get 1 Ampere out of the 
PEx without straining a thing. 

To do this, all we need to do is run a line from 
the + (positive) side of the PET's filter capac- 
ip2 r , and make u available at the rear of the 
PET (I put a test lead jack between the Parallel 
and IEEE Ports) . This is +8 VDC Unregulated and 
by attaching a 3-point Regulator (see diagram 
below), say at our project board, we have plenty 
of power for all sorts of home projects. As an 
example, I brought all of the Parallel User Port 
pinouts down a 24" ribbon cable along with the 
+8 VDC line to a chassis which has the +5 VDC 
regulator and other circuitry, and terminated 
this on a homebrew mother board comprised of 
22-pin edgecard connectors. I can now experi- 
ment with things such as noise makers, joy- 
sticks, etc. and have plenty of power for them. 

I believe this should be of great benefit for 
those of you who like to mess around with the 
hardware. Warning #1: if you are going to 
drill a hole in the PET as I did, disconnect all 
connectors (very, very gently) to the PET's Main 
Board and remove it before going to work. Clean 
inside thoroughly before re-installation. 
Warning #2: In your projects, do not connect 
inductive loads directly to any output of the 
PET. Inductive loads must be fully buffered. 



21,000 iiF 
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PET COMPOSITE VIDEO OUTPUT 

Cal E. Merritt 

R. I, 4 Richfield Lane 

Danville, IN 46122 



I used one of the existing PET 5 volt sources. 
The easiest way to steal the video and drives is 
to carefully scrape clean the foils next to the 
monitor plug and tack solder a twisted pair to 
each signal and to the closest ground buss. 
Other variations would work equally well . 

To avoid metal shavings and such falling on the 
main board, I removed the back cover from the 
monitor (Power OFF) and mounted a BNC jack two 
inches to the right of the brightness control 



The circuit is very simple and can be put to- 
gether with a wire wrap tool in a few minutes. 

Video monitors seem very tolerant and the two 
units I have used work fine. The only problem 
encountered was in attempting to do all white 
screen or very dense graphics which caused sync 
tear in one of the monitors . Normal or dense 
listings worked well . 



OUTPUT WAVEFORM 



VIDEO' 
DOTS. 





[ HORIZONTAL 
SYNC PULSES' 



VERTICAL 
INTERVAL 



and fed it with a twisted pair. I mounted the 
board under one of the bolts that hold the mon- 
itor to the main chassis and attached the drive 
twisted pairs to the existing ones for the mon- 
itor. 

This circuit provides composite video output 
from the PET. I have used the output to drive 
two different video monitors with good success. 



All three monitors I tried worked with this vid- 
eo output . The appearance of the video will be 
a function of the quality of the monitor. Some 
of the scrapped out commercial units available 
with the 10MHz and more band widths look excel- 
lent with the PET video. I have had a number of 
people comment that my 12" commercial monitor 
looks better than the built-in unit. The add-on 
does not alter the existing PET display in any 
way. 



PET V I DEO 




PET VERTICAL C °S"*?'" mE0 
DRIVE 



■=■ 100 
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DESIGN OF A PET/TTY INTERFACE 



Charles R. Husbands 

24 Blackhorse Drive 

Acton, MA 01720 



With the recent acquisition of a PET Computer 
one of the facilities that was immediately need- 
ed was a method of obtaining hard copy listings 
of programs under development. In addition to 
the PET, I had an ASR 33 Teletype Unit available 
which had been interfaced to my KIM-1 . This 
article describes the hardware interface and as- 
sociated software necessary to use the ASR 33 
TTY as a printing facility for the PET. An im- 
portant design goal for the interface was to de- 
velop the software to remain resident in the 
computer in such a manner that the program under 
development could be loaded, run and listed 
without disturbing the listing program. 

The Interface Circuit 

Figure 1 shows the 20 ma current loop circuit 
required to interface the ASR 33 to the PET. 
The circuit consists of an open collector NAND 
gate to provide the proper buffering, a diode 
and a pull up resistor. The completed circuit 
was built on a small perforated board. The PET 
supplies power and ground to the interface board 
from the second Cassette Interface . The input 
signal is delivered from PAO on the PET parallel 
user port. The interface board is connected to 
the teletype by means of the PRINTER and PRINTER 
RETURN lines. These lines attach to terminals 6 
and 7 respectively on the ASR 33. 



O +S-V 




PRINTER 



6 6MD 



Parts List 



IC1 


7438 


Quad 2 Input NAND Open Collector 


CR1 


1N4001 


1A 50V Diode 


R1 


150 ohm 


1/2 Watt Resistor 



Figure 1 . 

A fairly simple circuit for buffering the con- 
trol signal from the PET Computer and converting 
that signal to a current level capable of driv- 
ing the printer mechanism on an ASR 33 TTY Unit. 



Program Design 

In order to allow the listing program to remain 
resident in the machine to list other programs 
under development , the program was written in 
machine language to be stored in Tape Buffer 2. 
Figure 2 shows a simple memory map of the PET 
random access memory allocations. Without a 
second tape cassette unit , a memory buffer of 
198 bytes is available. When another program is 
loaded from tape or the NEW instruction is exe- 
cuted the operating system zeros out memory lo- 
cations 1024 and above. However, it leaves the 
memory locations below 1024 undisturbed. To ex- 
ecute a machine language program the USR in- 
struction must be called. The USR command uses 
a pair of memory location pointers stored in 
memory locations 1 and 2 to extablish the first 
location in machine language code to be process- 
ed. Locations 1 and 2 are not modified by the 
loading of a program from tape or the execution 
of the NEW instruction. 



8192 $1200 

Program Storage 

1024 $0500 

Tape Buffer 2 
826 $033A 

Tape Buffer 1 

634 $027A 

BASIC and Operating System Working Space 

2 $0002 

USR Control Pointers 
$0000 

Figure 2. 

A Map of the PET Random Access Memory Space. 
The Listing Program resides in machine language 
in Tape Buffer 2. 



A flow diagram of the Listing Algorithm is shown 
in Figure 3. The program after proper initia- 
tion examines the first character of the third 
line in the display for a value corresponding to 
the letter "R". It is the letter R appearing in 
the first display column which is used by the 
Listing Program to exit the listing algorithm 
and return control of the program to the calling 
routine. The R in the first column would nor- 
mally correspond to the READY displayed by the 
computer at the end of a requested listing block 
or at the completion of an executed RUN. If the 
character in the first column is anything but an 
R the program executes a carriage return and 
then a line feed. The program examines the next 
displayed character and translates it from dis- 
play format to ASCII format . The subroutine 
PRINT is then called. 
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( START) 


'1 


INIT 


1 


' . 



-> (LOOPl) 




( LOOP 2> 





1 


> 






EXAMINE NEXT CHAR 






1 


> 




CONVERT TO ASCII AND PRINT 




Figure 3. 

A general listing algorithm for use with the TTY 
Listing Program. The software control of the 
output port is done in the PRINT subroutine . 



The subroutine PRINT* is a machine language pro- 
gram which times out the proper serial bit pat- 
tern to the TTY to execute the printing of the 
designated letter. After each character is 
printed a counter is incremented and tested to 
determine if the 40 character line has been com- 
pleted. If 40 characters have not been printed 
the next display character is examined. At the 
end of each line the first character of the next 
line is examined for an R before a carriage re- 
turn and line feed is executed . 

A listing of the program in BASIC format is 
shown in Listing 1 . The program was originally 
hand assembled in 6502 machine language. The 
machine language program was then converted from 
hexadecimal to decimal and formatted as a series 
of POKE instructions . The machine language mem- 
ory address pointers were also POKED into loca- 
tions 1 and 2 by the BASIC program. The print- 
out appearing in Listing 1 was produced on the 
authors TTY using the Listing Program. 



Using the Listing Program 

The program as shown in Listing 1 is loaded into 
the machine in the normal manner . A RUN command 
is then executed and the program will be POKED 
in machine format into Tape Buffer 2. The BASIC 
program to be listed is then loaded into the 
machine. The LIST-N instruction is then execut- 
ed to allow the operator to preview the initial 
lines of code. When the operator is satisfied 
with the 15 to 18 lines of code to be printed, 
as displayed on the screen, the command X=USR(R) 
is entered and the RETURN key is depressed . The 
USR instruction transfers control to the machine 
language code located at the address specified 
by memory locations 1 and 2. 

The teletype printer will then print the display 
on the PET CRT from the beginning of display 
line 3 to the word READY. The operator then 
uses the LIST M-X command to preview the next 
series of lines to be printed. It should be 
noted that the PET listing format leaves a blank 
line between the last line number selected and 
the READY response if the last line requested is 
not the last line in the program. The preview 
function allows the operator to block out the 
lines to be printed regardless of the line num- 
bering technique employed when the program was 
composed . If the program being listed has an R 
in column 1 due to a line length in excess of 40 
characters, the operator must take some action 
to remove this condition before executing the 
listing of that portion of the program. 



Conclusions and Recommendations 

The hardware and software illustrated in this 
article can be used to permit the listing of 
programs and recording the results of program 
runs on a conventional TTY unit . In using the 
program to print the results of computer runs it 
should be noted that the results should be for- 
matted to begin on the third line of the dis- 
play. An improved version of this program could 
be designed to look ahead when an R was discov- 
ered to extablish if an RE or REA string was 
present. As only 3 bytes were not used in Tape 
Buffer 2 in writing this program, that feature 
could not be included. Additional space could 
be freed if the program was redesigned to use 
the parallel to serial conversion facility 
available with the 6522 VIA output port. Using 
this facility the 90 bytes required to do the 
conversion from parallel to serial and timing 
out this information could be greatly reduced. 



Listing 1 . 

A listing of the PET Listing Program as printed 
on the author's TTY unit. The program was hand 
assembled in 6502 language then converted to 
decimal format and entered as a series of BASIC 
"POKE" instructions. When executed the program 
will reside in Tape Buffer 2 in machine code 
format . 



* The PRINT subroutine is a modified version of 
the "PRINT 1 CHAR" program developed by M0S 
Technology for the KIM-1. 



57 



1 REi»)***TELETYPE LISTING 


ROUTINE****** 


546) 


2 REM CHARLES r. 


HUSbANLS 




550 


3 REM 










560 


4 REM THIS PROGRAM 


LISTS 


THE 


DATA 


570 


5 KtM APPEARING ON 


THE SCREEN 


IN 


579 


6 REM SERIAL TELETYPE FORMAT. 


THE 


580 


7 REM PROGRAM 


IS STORED IN MACHINE 


580 


8 REM CODE IN 


TAPE 


BUFFER 


#2. 


THE 


590 


9 REM Phil GRAM 


IS EX EC UT EL 


USING "USR". 


600 


If. 


POKEC01 >,58 








610 


20 


POKE(02),fi3 








620 


29 


REM . . I K I T . , 


. . IMTALIZE 


VARIABLES 


630 


30. 


POKE(S26), i 


169 








640 


4f! 


POKE(327>,00 








650 


bfri 


P0Kfc(828>, 1 


141 








660 


bf) 


POKE (829)., 25 1 








670 


7w 


PUKEC8 30), 03 








680 


8 


P0KEC831 ), 1 


I7f) 








690 


«b . 


REM. .LOO PI , 


. .TEST 


F IRST 


CHA 


R ON EACH 


698 


89 . 


HEM LINE FOR AN 


"K". 






699 


90 


POKE(832), ] 


:89 








700 


100 


P0KLC833) j 


.80 








710 


1 10 


PUKE(834> j 


- 128 








720 


150 


POKh(8 35) 3 


201 








730 


160 


P0KE(836) j 


■ 18 








740 


170 


PCKEC837)., 


>24f) 








750 


l«fi 


P0KE(«3« ) , 


83 








760 


1 8 9 


REN. .LOOP3. .PR I 


IvT CR/LF 




770 


1 9 f : 


H0KEC839) j 


169 








780 


2 0f> 


POKEC840) , 


13 








790 


2 If: 


PUKE (84 1 ), 


141 








800 


22 


PUKE (842), 


2 55 








810 


23H 


POKR(843>, 


3 








820 


240 


P0KR(844> , 


32 








830 


2 50 


P0KE(84 5) j 


166 








840 


2 60 


P0KE(84b), 


3 








8 50 
860 


270. 


P0KE<847), 


169 








861 


28 


P0Kt(84b), 


If. 








862 


29f> 


PGKE(849).» 


141 








863 


300 


PUKEC&50), 


2bb 








870 


3 1H 


P0KE(851 ), 


03 








880 


320 


P0KE(8b2), 


32 








890 


330 


P0KE(853), 


166 








899 


34fi 


P0KE(854), 


03 








900 


348 


REM. .LOOP2 


! . . EXA 


MINE AND PRINT THE 


910 


349 


REM OTHER 


i CHARACTERS 


ON ' 


THE LINE. 


91 1 


350 


P0KE(85b), 


189 








912 


3 6f) 


P0KE(856)j 


8 








913 


3 70 


P0KEC857), 


128 








914 


38 f) 


P0KE(8b8), 


141 










39 f< 


P0KEC8 59)., 


2 52 








917 


400 


POKM860), 


03 








918 


410 


P0KE<861 ), 


56 








9 1 9 


420 


P0KE(862>., 


233 








920 


430 


P0KE(863), 


32 








921 


440 


POKE(864), 


48 








92 1 


4 50 


P0KE(865>, 


12 








922 


460 


PUKEC866)., 


173 








923 


470 


P0KE(867>, 


252 








924 : 


480 


P0KE(868), 


03 








925 


490 


P0KEC869), 


141 








926 i 


bf.fi 


POKEC870), 


2 55 








927 


510 


POKEC871 ), 


03 








928 i 


b20 


P0KEC872), 


32 








929 i 


53f) 


P0KE(873), 


166 








930 1 



ALPHABETIC CHAR 



POKE(874),03 

P0KE<875>,76 

P0KE<876>,122 

POKE(877),03 

REM. .ALPHA. .PRINT 

P0KEC878), 173 

P0KEC878), 173 

P0KEC879),252 

POKE(880),03 

P0KEC88 1 ),24 

P0KE(882>, 105 

P0KEC883),64 

P0KEC884), 141 

P0KE<885>,255 

POKE(886),03 

P0KE(887>,32 

P0KE(888>, 166 



POKE(889>,03 

REM. .CLMUP. .COUNT CHARACTERS AND 

REM TEST FOR END OF LINE. 

POKE<890),238 

P0KE(891),251 

POKEC892),03 

P0KEC893), 173 

P0KE(894),251 

POKE(895),03 

POKE(896),201 

POKE(897),40 

POKE(898),240 

P0KEC899), 13 

POKE(900),232 

POKE(901 >, 138 

POKE(902),208 

POKE(903),06 

POKE<904),238 

POKE(905),89 

POKE<906),03 

POKE(907),238 

POKE(908)j66 

POKE(-909),03 

POKE(910), 76 

P0KE(91 1 ),87 

POKE<912>,03 

REM. .NEVL. .INITALIZES MEW LINE. 

P0KE(913)j 169 

POKE(914),00 

P0KEC915), 141 

P0KE(916),251 

POKEC917),03 

P0KE(918)#232 

P0KE(9 19),76 

POKE(920),64 

P0KE(921 ),03 

REM. .FINDR. .PROGRAM COMES HERE IF 

RtM AN "R" IS FOUND IN 1ST COLM. 

P0KE(922), 169 

P0KEC922), 169 

P0KE(923), 128 

P0KE<924>, 141 

P0KE(925),66 

POKE(926),03 

P0Kfc(927), 141 

P0KE(928) J 89 

PUKE(929),f.3 

PUKE(93f))>96 
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949 

95k) 

960 

961 

962 

963 

964 

965 

966 

970 

980 

990 

1000 

1010 

1020 

1030 

1040 

1050 

1060 

1070 

1080 

1090 

1 100 

1 1 10 

1 120 

1 130 

1 140 

1 150 

1 160 

1 170 

1 180 

1 190 

1 199 

1200 

1210 

1220 
1230 
1240 
1250 
1260 
1270 
1280 
1290 
1300 
1310 
1320 
1 330 
1340 
1350 

1360 
1370 
1380 
1390 
1400 
14 10 
1420 
1430 
1440 
14 50 
1460 
1470 
1480 
149^ 
,1500 



POKEC 
POKEC 
POKEC 
POKEC 
POKEC 
POKfct 
POKEC 
POKEC 
POKEC 
POKEC 
POKEC 
POKEC 
POKEC 
POKEC 
POKEC 

POKEC 
POKEC 
POKEC 
POKEC 
POKEC 
POKEC 
POKEC 
POKEC 
POKEC 
POKEC 
POKEC 
PUKEC 
POKEC 
POKEC 
POKEC 



965), 
966), 
967), 
968), 
969), 
9 7fc), 
971 ), 
972), 
973), 
974), 
975), 
976), 
977), 
978), 
979), 

980), 
981 ), 
962), 
983), 
984), 
985), 
986), 
987), 
988), 
989), 
990), 
991 ), 
992), 
993), 
994), 



79 

232 

41 

2 54 

78 

252 

03 

105 

00 

141 

79 

ii32 

32 

230 

03 

2 02 

208 

237 

173 

79 

232 

09 

01 

141 

79 

232 

32 

230 

03 

174 



995), 253 
996), 03 
997), 96 
DELAY 
998), 169 
999), 02 
1000), 141 
1001 ),254 
1002), 03 
1003), 169 
1004), 82 
DE2 

1005), 56 
DE4 
1006), 233 



REM.. PRIM'. .THIS SUBROUTINE PRINTS 1510 POKEC 

REM THE CHARACTER IN TTV FORMAT. 1520 POKEC 

POKEC934), 169 1530 POKEC 

P0KEC935),255 1539 REM.. 

P0KEC936), 141 1540 POKEC 

P0KEC937),67 1550 POKEC 

P0KEC938),232 1560 POKEC 

P0KEC939),173 1570 POKEC 

POKEC940),255 1580 POKEC 

POKEC 94 1), 03 1590 POKEC 

P0KEC942), 141 1600 POKEC 

P0KEC943),252 1609 REM.. 

POKEC944),03 1610 POKEC 

P0KEC945), 142 1619 REM.. 

P0KEC946),253 1620 POKEC 

POKEC947),03 

P0KEC948),32 1630 POKEC 1 00,7 ), 1 

POKEC949),230 1640 POKEC 1 008 ), 1 76 

POKEC950),03 1650 POKEC 1009), 03 

P0KEC951 ), 169 1660 POKEC 1 1 ), 206 

POKEC952),79 1670 POKEC 1 1 1 ), 254 

P0KEC953),232 1680 POKEC 1012 ), 03 

P0KEC954),4l 1689 REM..DE3 

P0KEC955),254 1690 POKEC 1 1 3 ) , 1 72 

P0KEC956), 141 1700 POKEC 16) 1 4), 254 

P0KEC957),79 1710 POKEC 10 1 5) , 03 

P0KEC958),232 1720 POKEC 1 1 6) , 1 6 

P0KEC959),32 1730 POKEC 1 1 7 ), 243 

POKEC960),230 1740 POKEC 1 1 8 ) , 96 

POKEC961),03 1750 REM. .COUNTC 1 1 9 ) 

POKEC 962), 162 1760 REM.. CHAR CI 020) 

POKEC963),08 1770 REM..TMPX C1021) 

REM..OUT1 1780 REM..TIMH C1022) 

P0KEC964), 173 1790 REM. . PCHARC 1 023 ) 

1800 END 



LABEL OP 


FIELD 


LOC 


OP 


P1 


F2 


INIT LDA 


#0 


826 


169 


00 




STA 


COUNT 


828 


141 


251 


03 


TAX 




831 


170 






LOOP1 LDA 


32848.X 


832 


189 


80 


128 


CMP 


#18 


835 


201 


18 




BEQ 


FINDR 


837 


240 


83 




LOOP3 LDA 


#0D 


839 


169 


13 




STA 


PCHAR 


841 


141 


255 


03 


JSR 


PRINT 


844 


32 


166 


03 


LDA 


#0A 


847 


169 


10 




STA 


PCHAR 


849 


141 


255 


03 


JSR 


PRINT 


852 


32 


166 


03 


LOOP2 LDA 


32848, X 


855 


189 


80 


128 


STA 


CHAR 


858 


141 


252 


03 


SEC 




861 


56 






SBC 


#20 


862 


233 


32 




BMI 


ALPHA 


864 


48 


12 




LDA 


CHAR 


866 


173 


252 


03 


STA 


PCHAR 


869 


141 


255 


03 


JSR 


PRINT 


872 


32 


166 


03 


JMP 


CLNUP 


875 


76 


122 


03 



59 



ALPHA 


LDA 


CHAR 


878 


173 


252 


03 




CLC 




881 


24 








ADC 


#40 


882 


105 


64 






STA 


PCHAR 


884 


141 


255 


03 




JSR 


PRINT 


887 


32 


166 


03 


OLNUP 


INC 


COUNT 


890 


238 


251 


03 




LDA 


COUNT 


893 


171 


251 


03 




(JMP 


#28 


896 


201 


40 






BEQ 


NEWL 


898 


240 


13 






INX 




900 


232 








TAX 




901 


138 








BNE 


NEXTC 


902 


208 


06 






INC 


869 


904 


238 


89 


03 




INC 


834 


907 


238 


66 


03 


NEXTC 


JMP 


L00P2 


910 


76 


87 


03 


NEWL 


LDA 


#0 


913 


169 


00 






STA 


COUNT 


915 


141 ; 


251 


03 




INX 




918 


232 








JMP 


L00P1 


919 


76 


64 


03 


FINDR 


LDA 


#80 


922 


169 


128 






STA 


834 


924 


141 


66 


03 




STA 


860 


927 


141 


89 


03 




RTS 




930 


96 






PRINT 


LDA 


#PF 


934 


169 : 


255 






STA 


PALD 


936 


141 


67 


232 




LDA 


PCHAR 


939 


173 I 


255 


03 




STA 


CHAR 


942 


141 ; 


252 


03 




STX 


TMPX 


945 


142 


253 


03 




JSR 


DELAY 


948 


32 


230 


03 




LDA 


SAD 


951 


169 


79 


232 




AND 


#PE 


954 


41 


254 






STA 


SAD 


956 


141 


79 


232 




JSR 


DELAY 


959 


32 


230 


03 




LDX 


#08 


962 


162 


08 




0UT1 


LDA 


SAD 


964 


173 


79 


232 




AND 


#PE 


967 


41 


254 






LSR 


CHAR 


969 


78 


252 


03 




ADC 


#00 


972 


105 


00 






STA 


SAD 


974 


141 


79 


232 




JSK 


DELAY 


977 


32 


230 


03 




DEX 




980 


202 








BNE 


0UT1 


981 


208 


237 






LLA 


SAD 


983 


173 


79 


232 




ORA 


#01 


986 


09 


01 






STA 


SAD 


988 


141 


79 


232 




JSR 


DELAY 


991 


32 


230 


03 




LDX 


TMPX 


994 


174 


253 


03 




RTS 




997 


96 






DELAY 


LDA 


#02 


998 


169 


02 






STA 


TIMH 


1000 


141 


254 


03 




LDA 


#52 


1003 


169 


82 




JJE2 


s±;c 




1005 


56 






JJE4 


SBC 


#01 


1006 


233 


01 






iiCS 


DE3 


1008 


176 


03 






DEC 


TIMH 


1010 


206 


254 


03 


LE3 


LDY 


TIMH 


1013 


172 


254 


03 




BPL 


DE2 


1016 


16 


243 






KTS 




1018 








COUNT 


(1019) 










CHAR 


(1020) 










TMPX 


(1021) 










TIMH 


(1022) 










PCHAR 


(1023) 
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THE PET VET EXAMINES 
SOME BASIC IDIOSYNCRASIES 



Charles Floto 
325 Pennsylvania Ave , 



S.E. 



Washington, DC 20003 



Richard Rosner has supplied a program 
listing produced using his RS-232 
printer interface for the PET. As it's 
well commented I'll only point out ex- 
amples of some of the unusual features 
of PET BASIC. 

Line 1 is an example of the OPEN state- 
ment. The first number specifies that 
it applies to logical file number 5. 
This is the name by means of which 
other statements in the program will 
use this data file. The second number 
specifies that physical device number 5 
is being used. Which device is number 
5 is determined by the wiring of the 
system. 

The PET, as sold, is wired for device 
the keyboard; 1, the built-in tape 
drive; 2, the auxiliary drive connector 
on the back; and 3> the screen. Refer- 
ring to a physical device that hasn't 
been electrically connected will result 
in a DEVICE NOT PRESENT ERROR. Rich- 
ard's system does contain a physical 
device 5: his RS-232 output port. 

If the third number in the OPEN state- 
ment is 0, reading the file is enabled. 
Writing is prepared for by 1 , while a 2 
here enables file writing with an end- 
of-tape character to be added when the 
file is CLOSEd. 

Line 2 illustrates the use of CMD. It 
allows program commands to be applied 
to a device specified by the logical 
file connected with it (not by the 
physical device number) . Note that RUN 
will merely cause a listing to be pro- 
duced. RUN 5 calls the rest of the 
program into action. 



Line 2000 demonstrates use of the OPEN 
statement with a variable. Lines 2000- 
2300 print data either on the tape 
drive or on the screen depending on 
which device number is the current val- 
ue of variable D. In each case logical 
file 8 is used. 

Another idiosyncrasy comes up here: 
while PRINT may be entered as ? , PRINT* 
cannot be entered as ?# - it must be 
spelled out. Otherwise a SYNTAX ERROR 
will result when the program is run, 
even though the listing will look al- 
right . 

But you can still save a good deal of 
typing entering these lines. Once 2110 
is in simply move the cursor up to 
change the line number to 2111 and NA 
to AD. Then hit RETURN and you'll have 
both 2110 and 2111 in memory. 

I suggest you make a few changes in 
Richard's program. Add 105 DIM ST$(C0) 
Consider storing the zip code as a 
string rather than as an integer. Re- 
peat lines 2000-2300 as 5000-5300 (by 
changing the first digit in each line 
number) and change line 4500 according- 
ly. Then you can alter the display 
format without messing up the tape for- 
mat. And remember that you can slow 
screen printing by holding the RVS key 
down. 

A final note: I understand Commodore 
is now using a different tape drive and 
recording system. This may create 
compatibility problems in exchanging 
programs between the early PETs and the 
later ones. 



1 OPEN 5,5, 1 /'Mailing List Program (Incomplete)" 

2 CMD5:PRINT»" :LIST:END 

5 REM THE ABOVE LINES LIST THE PROGRAM ON THE HARD COPY UNIT 

10 REM 

11 REM WRITTEN BY RICHARD ROSNER 

12 REM BROOKFIELD, CONN. 

13 REM FOR THE COMMODORE PET. 

14 REM PRINTED ON A GE PRINTER 

15 REM USING A PET ADA AVAILABLE FROM THE AUTHOR. 
49 REM D=DEVICE CODE 
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50 D=l »REM TAPE DRIVE #1 

90 CO=50 

91 REM CO=MAX NO. OF RECORTS IN LIST 
100 DIM NA$(CO),AD$(CO),CI$(CO) 

REM NA$=NAME,AD$=ADDRESS,CI $=CITY 
REM ST$ = STATE, Z=Z IP CODE 

REM KC=KEY CODE. UP TO 10 FOR EACH ADDRESS 
DIM Z(CO),KC%(I0,CO) 
REM ENTER RECORDS FOR MAILING LIST 
REM EXIT ON '!' FOR NAME 
FOR N=0 TO CO 



101 
102 
103 
110 
997 
998 
1000 
1010 
1020 
1025 
1030 
1040 
1050 
1060 
1070 
1080 
1 100 
1 180 
1998 
2000 
2009 
2010 
2100 
21 10 
21 1 I 
2112 
2113 
21 15 
2120 
2130 
2150 
2200 
2300 
3000 
3997 
3998 
4000 
4010 
401 1 
4100 
4 110 
4120 
4130 
4131 
4132 
4135 
4140 
4150 
4160 
4190 
4200 
4300 
4500 
READY. 



ST$(N) 



,N) 



=3) 



INPUT"NAME";NA$(N) 

IF NA$(N)=" !■" GOTO 2000 

LN=N 

INPUT"ADDRESS" ;AD$(N) 

INPUT"CITY, STATE"; CI $(N) 

INPUT"ZIP CODE"; Z(N) 

FOR N1=0 TO 10 

PRINT "KEY#";N1 ; *INPUT KC%(N1 

IF KC%(N1 ,N)=0 GOTO 1 180 

NEXTN1 

NEXT N 

PRINT ON TAPE DRIVE(D=1 ) OR SCREEN (D= 

OPEN 8, D, I ."ADDRESS FILE" 

REM LN=NUMBER OF RECORDS 

PRINT#8,LN 

FOR N=0 TO LN 

PRINT#8,NA$(N) 

PRINT#8,AD$(N) 

PRINT#8,CI$(N) 

PRINT#8,ST$(N) 

PRINT#8,Z(N) 

FOR N1=0 TO 10 

PRINT#8,KC%(N1 ,N) 

NEXT Nl 

NEXT N 

CLOSE 8 

END 

REM ENTER AT 4000 TO READ IN FROM TAPE 

REM DRIVE N0. 1 AND THEM PRINT ON SCREEN 

OPEN 8,1 ,0, "ADDRESS FILE" 

INPUT#8,LN 

PRINTLN:REM PRINT RECORD COUNT 

FOR N=0 TO LN 

INPUT#8,NA$(N) 

REM IF ST1 AND 64 GOTO 4300 

INPUT#8,AD$(N) 

INPUT#8,CI$(N) 

INPUT#8,ST$(N) 

INPUT#8,Z(N) 

FOR N1=0 TO 10 

INPUT#8,KC%(N1 ,N) 

NEXTNI 

PRINTN:REM PRINT RECORD NO. AS READ 

NEXT N 

CLOSE 8 

D=3:G0T0 2000 
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THE PET VET TACKLES DATA FILES 



Charles Floto 

325 Pennsylvania Ave., S.E. 

Washington, DC 20003 



Several people have contacted the PET 
Vet about their difficulties in record- 
ing data files on tape and reading the 
information back in. Preliminary in- 
formation on PET BASIC lists the com- 
mands to be used, but doesn't tell how 
to put them together. This makes for a 
frustrating situation, especially as 
file handling should be one of the 
PET's strong points. 

The following program is offered as a 
starting point for development accord- 
ing to your specific application. 
Reading and writing have been combined 
in one program for two reasons. First, 
modifications to one process may call 
for corresponding changes in the other. 
Second, this minimizes the need to jug- 
gle two cassettes while saving programs 
on one and data on the other. I rec- 
ommend that a separate cassette be used 
for data storage. If you use this pro- 
gram please save it on tape before you 
try to run it. I have found that while 
I'm experimenting with data files, the 
PET is especially liable to go out of 
control, forcing me to turn off the 
power. The same memory location that 
controls the tape drive apparently con- 
trols a function essential to BASIC. 



To write a data file load this program, 
have a blank cassette in the tape drive 
and type RUN. Line 50 clears the 
screen. Lines 60-300 build a string 
consisting of: a file name or record 
number followed by two asterisks; data 
to be saved that may be broken into 
data fields by delimiters of your 
choice; and three consecutive back- 
slashes that mark the end of the re- 
cord. Lines 90 and 100 cause the key- 
board to be read until a key is struck. 
Then 105 echoes it to the screen and 
110 adds it to the string. Use of GET 
rather than INPUT allows the data file 
to contain commas and carriage returns. 
Line 190 warns when C$ is approaching 
the maximum size; you may wish to have 
a later or less frequent warning. At 



the end of the record type three back- 
slashes. These will be detected in 
line 300, causing 320 to be executed 
rather than going back to 90 for an- 
other character. 

Lines 320-400 write C$ onto the tape. 
You will be instructed (on the screen) 
to press play and record on the tape 
drive if you have not already done so. 
In line 320 the first two numbers in- 
dicate that device #1 is tape drive 1. 
The third 1 indicates a write opera- 
tion. Compare this to line 1000 
where the indicates a read command. 

Line 450 provides for creation of the 
next record in the file. To create the 
last record simply input the record 
number and type three backslashes. 
Then, after it has been written, BREAK 
IN 500 will appear on the screen. 

At this point you're ready to rewind 
the tape and type RUN 900. Lines 910 
to 990 initialize 256 empty strings. 
Lines 1000-1090 read the tape and build 
up C$ until three consecutive back- 
slashes are found. Line 2000 prints 
what has been read while 2850 displays 
available memory. Then in 3000-3020 C$ 
is broken down into its individual ele- 
ments. These can be manipulated fur- 
ther by adding your own lines between 
3050 and 9000. Line 9000 will head 
back to read the next record unless 
3050 has detected the last record in a 
file. 

To record numeric data generated in 
a program rather than entered from the 
keyboard it must be converted to a 
string with the STR$ function. Then 
when it's read back the VAL function 
can be used on data fields representing 
numbers. For example, N=VAL(B$(8)+ 
B$(9)+B$(10)) might be used if you knew 
the eighth, ninth and tenth elements of 
C$ represented a three-digit number. 
Of course, it usually won't be nearly 
so simple as that. 
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If you have any problems with specific 
applications of your PET, drop me a 
note, preferably giving a phone number 
where you can be reached evenings and 
weekends. I'd also be interested to 
see any information you've been able to 
pry out of Commodore or discover on 
your own. 



50 PRINT CHR$(147) 

60 PRINT "ENTER FILE NAME OR RECORD #" 

70 INPUT C$ 

80 C$ = C$+"**'» 

90 GET A$ 

100 IF A$=""THEN 90 

105 PRINT A$; 

110 C$=C$+A$ 

190 IF LEN(C$)>200 THEN PRINT 255-LEN(C$); "BYTES AVAILABLE" 

300 IF RIGHT$(C$,3)<>"\\\" THEN 90 

320 OPEN 1 , 1 , 1 ,"NAILFILE" 

350 PRINT#1 ,C$ 

400 CLOSE 1 

450 IF RIGHT$(C$,5)<>"**\\\" THEN 50 

500 STOP 

900 DIM B$(255) 

910 FOR J=1 TO 255 

920 B$(J)="" 

930 NEXT J 

990 C$="" 

1000 OPEN 1 , 1 ,0,"NAILFILE" 

1010 GET#1 ,A$ 

1020 C$=C$+A$ 

1030 IF A$<>"\" THEN SL=0:GOTO 1010 

1040 SL=SL+1 

1050 IF SL<3 THEN 1010 

1090 CLOSE 1 

2000 PRINT C$ 

2850 PRINT FRE(0); "BYTES FREE" 

3000 FOR J=1 TO LEN(C$) 

3010 B$(J)=MID$(C$, J, 1 ) 

3020 NEXT J 

3030 PRINT FRE(0); "BYTES FREE" 

3050 IF RIGHT$(C$,5)="**\\\" THEN END 

9000 GOTO 910 
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A PARTIAL LIST OF PET SCRATCH PAD MEMORY 

Gary A. Creighton 

625 Orange Street, No. 43 

New Haven, CT 06510 

A function and a symbol defined: 

DEF FN IND(LOC) = PEEK ( L0C+ ! ) * 256+PEEK ( LOC) 

Which specifies an indirect address in the f orm : LOC+ 1 = ( Page) 

LOC =(Item) 
M(LOC) specifies contents of a memory location. 

M(0) JMP instruction 

FN IND(1) USR jump location 

M(3) Present I/O Device Number (suppress printout) 

M(5) POS function store 

FN IND(8) Arguments of commands with range to 65535 

" (PEEK, POKE, WAIT, SYS, GOTO, GOSUB, Line Number, RAM check) 

M(10-89) Input Buffer 

M(90-98) Flags for MISMATCH, Distinguishing between similar 

subroutines, etc. 

M(91) Ignore Code Value and do direct (between quotes, etc.) 

M(98) (0 INPUT, 64 GET/GET#, 152 READ) Flag 

FN IND(113) Transfer Number pointer 

FN IND(115) Number pointer 

FN IND(122) Begin Basic Code pointer 

FN IND(124) Begin Variables pointer 

FN IND(126) Variable List pointer 

FN IND(128) End Variables pointer 

FN IND(130) Lowest String Variables pointer 

FN IND(132) Highest String Variables pointer 

FN IND(134) First Free After Strings pointer 

FN IND(136) Present Line Number (if M(137)=255, no line number) 

FN INDC138) Line Number at BREAK 

FN IND(140) Continue Run pointer (if M(141)=0, can't continue) 

FN IND(142) Line Number of Present DATA line 

FN IND(144) Next DATA pointer (for READ) 

FN IND(146) Next Data/Input After Last Comma pointer 

M(148) Coded 1st Character of Last Variable 

M(149) Coded 2nd Character of Last Variable 

FN ND(150) Variable pointer (all variables) 

FN IND(152) Variable pointer 

M(156) Comparison Symbol Accumulator (<=>) 

FN IND(157) Pointer to FN pointer 

M( 1 57-1 61) Number Store/Work area (SQR) 

M( 163-1 65) JMP (FN IND(164)) 

FN IND(164) Function Jump address 

M(166-170) Number Store/Work area ( Transcendental s (not EXP) & SQR) 

M( 171-175) Number Store/Work area ( Transcendentals & SQR) 

M( 176-181 ) Main Number Store/Work area 

M( 1 8 1 ) Number Sign 

M( 184-189) Secondary Number Store/Work area 

M(192) Length of things in Input Buffer M(10-89) or 

Length of things in Output Number M(256- )... other 

M( 194-217) Subroutine: Point through code one at a time, RTS with 

code value in accumulator and Carry Flag Clear if 

if end of line. Ignore Spaces. ASC(0-9) 

FN IND(201) Code Pointer 

M(218~222) Number Store/Work area (RND) 

FN IND(224) Screen Memory Row location 

M(226) Screen Column position 
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FN IND(227) 

M(234) 

M(238) 

M(239) 

M(240) 

M(241) 

M(242) 

FN IND(243) 

M(245) 

FN INDC247) 
M(2.51) 
M(256) 
M(256- ) 

M(31 1?-51 1 ) 

M(512-514) 

M(515) 

M(516) 

M( 517-5 1 8) 

M(521) or 

M(59410) 



\ 



M(523) 
M(524) 
M(525) 
M(526) 
MC527-536) 
FN IND(537) 
FN IND(539) 
M(547) 



M(548) 

M(5t9) 
M(550) 

M(551) 

M(553-577) 

M(578-587) 

M(588-597) 

M(598-607 

M(608) 

M(610) 

M(61 1) 

M(612) 

M(616) 

M(634-825) 

MC826-1023) 



I/O Option 
Device # 
Wraparound 
Tape #1 or 
Screen Row 

Load into/ 



Move Memory (from or to) pointer 

Quote flag (0 end quote) (1 begin quote) 

Length of File name after SAVE, VERIFY etc. 

File # 

(0 read, 1 write, 2 write/EOT) 

(0 keyboard, 1 tape#1, 2 tpae#2, 3 screen) 

flag (39 single line, 79 2nd of double line) 

#2 Buffer pointer 

(0 - 24) 

Verify from? Save into pointer 
Insert Counter ( INST) 

Minus sign or Space for Output Number 
Output Number ASC Digits til a Null (0) or 
Tape Read Working Storage 
Stack area 
TI clock 

Only One Value per Keypush flag 
SHIFT flag (0 no shift, 1 shift) 
TI Update Interrupt Counter 
Bit Cancel Keys 

the following rules: 



Turns bits off under 



BIT 



1 

2 

3 

4 

5 
6 

7 



KET 
RVS 

space 

stop 
( none ) 



DECIMAL # 

254 
253 
251 
247 
239 

191 
127 



More than one key 

may be pushed at once 

Decimal # is Binary 
equival ent . 



VERIFY/LOAD flag (0 LOAD, 1 VERIFY) 

ST Status 

Key Pushed Counter (MOD 10) 

RVS flag (0 RVS off, 1 RVS on) or any key pushed) 

Input Run Buffer (keys stored during a RUN 

Interrupt Vector (normally at: Store Keypush 

BRK instruction Vector (User loaded) in Input Run Buffer) 

Keyboard Input Code 

(Stays equal to Input code til finger off key, 

Matches up one to one with M( 59228-59 307 ) which is 

Keyboard Input Code to ASC Code Table) 

Blink Cursor flag (if (no key pushed)) 

Cursor Blink Duration counter (20 interrupts) 

Screen Value of Input Char, when Cursor moves on 

Insure no Cursor Breadcrumbs left behind 

Screen Page Array / single or double Line flags 

File # of one of 10 files 

Device # of one of 10 files 

I/O option one of 10 files 

Input from screen/Input from keyboard flag 

Number of Open Files 

Device Number of Input Device (0 keyboard normally) 

Device Number of Output Device (3 screen normally) 

Tape Buffer Item Counter 

Tape #1 Buffer area 

Tape #2 Buffer area 
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LIFE FOR YOUR PET 

Dr. Frank H. Covitz 

Deer Hill Road 

Lebanon, NJ 08833 



Since this is the first time I have 
attempted to set down a machine lang- 
uage program for the public eye, I will 
attempt to be as complete as practical 
without overdoing it. 

The programs I will document here are 
concerned with the game of "LIFE", and 
are written in 6502 machine language 
specifically for the PET 2001 (8K ver- 
sion) . The principles apply to any 
6502 system with graphic display capa- 
bility, and can be debugged (as I did) 
on non-graphic systems such as the 
KIM-1. 

The first I heard of LIFE was in Martin 
Gardner's "Recreational Mathematics" 
section in Scientific American, Oct-Nov 
1970; Feb. 1971. As I understand it, 
the game was invented by John H. Con- 
way, an English mathematician. In 
brief, LIFE is a "cellular automation" 
scheme , where the arena is a rectang- 
ular grid (ideally of infinite size). 
Each square in the grid is either occu- 
pied or unoccupied with "seeds", the 
fate of which are governed by relative- 
ly simple rules, i.e. the "facts of 
LIFE". The rules are: 1. A seed sur- 
vives to the next generation if and on- 
ly if it has two or three neighbors 
(right, left, up, down, and the four 
diagonally adjacent cells) otherwise it 
dies of loneliness or overcrowding, 
as the case may be. 2. A seed is born 
in a vacant cell on the next genera- 
tion if it has exactly 3 neighbors. 

With these simple rules, a surprisingly 
rich game results. The original Scien- 
tific American article, and several 
subsequent articles reveal many curious 
and surprising initial patterns and 
results. I understand that there even 
has been formed a LIFE group, complete 
with newsletter, although I have not 
personally seen it. 



The game can of course be played man- 
ually on a piece of graph paper, but it 
is slow and prone to mistakes, which 
have usually disasterous effects on the 
final results. It would seem to be the 
ideal thing to put to a microprocessor 
with bare-bones graphics, since the 
rules are so simple and there are es- 



sentially no arithmetic operations in- 
volved, except for keeping track of ad- 
dresses and locating neighbors. 

As you know, the PET-2001 has an excel- 
lent BASIC interpreter, but as yet very 
little documentation on machine lang- 
uage operation. My first stab was to 
write a BASIC program, using the entire 
PET display as the arena (more about 
boundaries later) , and the filled 
circle graphic display character as the 
seed. This worked just fine, except 
for one thing - it took about 2-1/2 
minutes for the interpreter to go 
through one generation! I suppose I 
shouldn't have been surprised since the 
program has to check eight neighboring 
cells to determine the fate of a par- 
ticular cell, and do this 1000 times to 
complete the entire generation (40x25 
characters for the PET display) . 

The program following is a 6502 version 
of LIFE written for the PET. It needs 
to be POKE'd into the PET memory, 
since I have yet to see or discover a 
machine language monitor for the PET. 
I did it with a simple BASIC program 
and many DATA statements (taking up 
much more of the program memory space 
than the actual machine language pro- 
gram!). A routine for assembling, and 
saving on tape machine language pro- 
grams on the PET is sorely needed. 

The program is accessed by the SYS com- 
mand, and takes advantage of the dis- 
play monitor (cursor control) for in- 
serting seeds, and clearing the arena. 
Without a serious attempt at maximizing 
for speed, the program takes about 1/2 
second to go through an entire genera- 
tion, about 300 times faster than the 
BASIC equivalent! Enough said about 
the efficiency of machine language pro- 
gramming versus BASIC interpreters? 



BASIC is great for number crunching, 
where you can quickly compose your pro- 
gram and have plenty of time to await 
the results. 

The program may be broken down into 
manageable chunks by subroutining. 
There follows a brief description of 
the salient features of each section: 
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MAIN (hex 1900) 

In a fit of overcaution (since this was 
the first time I attempted to write a 
PET machine language program) you 
will notice the series of pushes at the 
beginning and pulls at the end. I de- 
cided to save all the internal regis- 
ters on the stack in page 1, and also 
included the CLD (clear decimal mode) 
just in case. Then follows a series of 
subroutine calls to do the LIFE genera- 
tion and display transfers. The zero 
page location, TIMES, is a counter to 
permit several loops through LIFE be- 
fore returning. As set up, TIMES is 
initialized to zero (hex location 1953) 
so that it will loop 256 times before 
jumping back. This of course can be 
changed either initially or while in 
BASIC via the POKE command. The return 
via the JMP BASIC (4C 8B C3) may not be 
strictly orthodox, but it seems to work 
all right. 

INIT (hex 1930) and DATA (hex 193B) 

This shorty reads in the constants 
needed, and stores them in page zero. 
SCR refers to the PET screen, TEMP is 
a temporary working area to hold the 
new generation as it is evolved, and 
RCS is essentially a copy of the PET 
screen data, which I found to be neces- 
sary to avoid "snow" on the screen dur- 
ing read/write operations directly on 
the screen locations. Up, down, etc. 
are the offsets to be added or subtrac- 
ted from an address to get all the 
neighbor addresses. The observant 
reader will note the gap in the addres- 
ses between some of the routines. 



TMPSCR (hex 1970) 

This subroutine quickly transfers the 
contents of Temp and dumps it to the 
screen, using a dot (81 dec) symbol for 
a live cell (a 1 in TEMP) and a space 
(32 dec) for the absence of a live cell 
(a in TEMP). 

SCRTMP (hex 198A) 

This is the inverse of TMPSCR, quickly 
transferring (and encoding) data 
from the screen into TEMP. 

RSTORE (hex 19A6) 

This subroutine fetches the initial 
addresses (high and low) for the SCR, 
TEMP, and RCS memory spaces. 



NXTADR (hex 19BD) 

Since we are dealing with 1000 bytes of 
data, we need a routine to increment to 
the next location, check for page cros- 
sing (adding 1 to the high address when 
it occurs), and checking for the end. 
The end is signaled by returning a 01 
in the accumulator, otherwise a 00 is 
returned via the accumulator. 



TMPRCS (hex 19E6) 

The RCS address space is a copy of the 
screen, used as mentioned before to 
avoid constant "snow" on the screen if 
the screen were being continually ac- 
cessed. This subroutine dumps data 
from TEMP, where the new generation has 
been computed, to RCS. 

GENER (hex 1A00) 

We finally arrive at a subroutine where 
LIFE is actually generated. After 
finding out the number of neighbors of 
the current RCS data byte from NBRS, 
GENER checks for births (CMPIM $03 at 
hex addr. 1A0E) if the cell was prev- 
iously unoccupied. If a birth does not 
occur, there is an immediate branch to 
GENADR (the data byte remains 00). If 
the cell was occupied (CMPIM 81 dec at 
hex 1A08), 0CC checks for survival 
(CMPIM $03 at hex 1A1A and CMPIM $02 at 
hex 1A1E), branching to GENADR when 
these two conditions are met, otherwise 
the cell dies (LDAIM $00 at hex 1A22). 
The results are stored in TEMP for the 
1000 cells. 

NBRS (hex 1A2F) 

NBRS is the subroutine that really does 
most of the work and where most of the 
speed could be gained by more efficient 
programming. Its job, to find the tot- 
al number of occupied neighbors of a 
given RCS data location, is complicated 
by page crossing and edge boundaries. 
In the present version, page crossing 
is taken care of, but edge boundaries 
(left, right, top, and bottom of the 
screen) are somewhat "strange". Above 
the top line and below the bottom line 
are considered as sort of forbidden re- 
gions where there should practically 
always be no "life" (data in those re- 
gions are not defined by the program, 
but I have found that there has never 
been a case where 81's have been pres- 
ent (all other data is considered as 
"unoccupied" characters) . The right 
and left edges are different, however, 
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and lead to a special type of "geom- 
etry". A cell at either edge is not 
considered as special by NBRS, and so 
to the right of a right-edge location 
is the next sequential address. On the 
screen this is really the left edge 
location, and one line lower. The in- 
verse is true, of course for left ad- 
dresses of left-edge locations. Topo- 
logically, this is equivalent to a 
"helix". No special effects of this 
are seen during a simple LIFE evolution 
since it just gives the impression of 
disappearing off one edge while appear- 
ing on the other edge. For an object 
like the "spaceship" (see Scientific 
American articles), then, the path 
eventually would cover the whole LIFE 
arena. The fun comes in when a config- 
uration spreads out so much that it 
spills over both edges, and interacts 
with itself. This, of course cannot 
happen in an infinite universe, so that 
some of the more complex patterns will 
not have the same fate in the present 
version of LIFE. Most of the "blink- 
ers", including the "glider gun" come 
out OK. 



language on the PET. One confession, 
however - I used the KIM-1 to debug 
most of the subroutines. Almost all of 
them did not run on the first shot! 
Without a good understanding of PET 
memory allocation particularly in page 
zero, I was bound to crash many times 
over, with no recovery other than pul- 
ling the plug. The actual BASIC pro- 
gram consisted of a POKING loop with 
many DATA statements (always save on 
tape before running!). 

Although the LIFE program was designed 
for use on the PET (8K version), no 
references are made to PET ROM loca- 
tions or subroutines, and except for 
MAIN and SUBROUTINE address, are fully 
relocatable. The PET screen addresses 
(8000 - 83E8 hex) are treated as RAM. 
For anyone (with a 6502-based system) 
trying to convert the PET program, the 
following points need to be watched: 

1. The BLANK symbol = 20 hex 

2. The DOT symbol = 51 hex 

3. The OFFSETS in DATA must be set 
for the user's display. 



This M0x25 version of LIFE can undoubt- 
edly be made more efficient, and other 
edge algorithms could be found, but I 
chose to leave it in its original form 
as a benchmark for my first successful- 
ly executed program in writing machine 



A Brief Introduction 
to the Game of Life 

by Mike Rowe 

One of the interesting properties of 
the game of LIFE is that such simple 
rules can lead to such complex activ- 
ity. The simplicity comes from the 
fact that the rules apply to each in- 
dividual cell. The complexity comes 
from the interactions between the indi- 
vidual cells. Each individual cell is 
affected by its eight adjacent neigh- 
bors, and nothing else. 

The rules are: 



2. A cell dies from overcrowding if it 
has four or more neighbors. It dies 
from isolation if it has one or zero 
neighbors. 

3. A cell is born when an empty space 
has exactly three neighbors. 

With these few rules, many different 
types of activity can occur. Some pat- 
terns are STABLE, that is they do not 
change at all. Some are REPEATERS, 
patterns which undergo one or more 
changes and return to the original 
pattern. A REPEATER may repeat as fast 
as every other generation, or may have 
a longer period. A GLIDER is a pattern 
which moves as it repeats. 



1 . A cell survives if it has two or 
three neighbors. 

REPEATERS 



* * 

» * 



STABLE 

* 
* * 
ft « 

« 



ft « 

* « 



« « 



ft • * 
ft « ft 



* « 

• » 



* • 



* « » 
* « * 



GLIDERS 



« * 

* « « 
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1900 



LIFE ORG $1900 



1900 
1900 
1900 
1900 

1900 
1900 
1900 
1900 
1900 
1900 
1900 
1900 
1900 
1900 
1900 
1900 
1900 
1900 
1900 
1900 
1900 
1900 
1900 
1900 
1900 
1900 
1900 
1900 
1900 
1900 
1900 

1900 08 

1901 18 

1902 8A 

1903 48 

1904 98 

1905 48 

1906 BA 

1907 8A 

1908 48 

1909 D8 

190A 20 30 19 
190D 20 8A 19 

1910 20 E6 19 
1913 20 00 1A 
1916 20 70 19 

1919 E6 38 
191B DO F3 
191D 68 
191E AA 
191F 9A 

1920 68 



BASIC « 
OFFSET « 
DOT « 
BLANK « 



SCRL 

SCRH 

CHL 

CHH 

SCRLO 

SCRHO 

TEMPL 

TEMPH 

TEMPLO » 

TEMPHO * 

UP 

DOWN 

RIGHT 

LEFT 

UR 



UL 

LR 

LL 

N 

SCRLL 

SCRLH 

RCSLO 

RCSHO 

TMP 

TIMES 

RCSL 

RCSH 

MAIN 



GEN 



* 
* 

« 
* 
* 
* 
* 
* 
* 
* 
» 

* 
* 

* 

PHP 

PHA 

TXA 

PHA 

TYA 

PHA 

TSX 

TXA 

PHA 

CLD 

JSR 

JSR 

JSR 

JSR 

JSR 

INCZ 

BNE 

PLA 

TAX 

TXS 

PLA 



$C38B 
$002A 
$0051 
$0020 

$0020 
$0021 
$0022 
$0023 
$0024 

$0025 
$0026 
$0027 
$0028 
$0029 
$002A 
$002B 
$002C 
$002D 
$002E 
$002F 
$0030 
$0031 
$0032 
$0033 
$0034 
$0035 
$0036 
$0037 
$0038 
$0039 
$003A 



INIT 

SCRTMP 

TMPRCS 

GENER 

TMPSCR 

TIMES 

GEN 



RETURN TO BASIC ADDRESS 
PAGE ZERO DATA AREA POINTER 
DOT SYMBOL = 81 DECIMAL 
BLANK SYMBOL = 32 DECIMAL 

PAGE ZERO LOCATIONS 



SAVE EVERYTHING 
ON STACK 



CLEAR DECIMAL MODE 



REPEAT 255 TIMES 
BEFORE QUITTING 
RESTORE EVERYTHING 



68 



1921 A8 TAY 

1922 68 PLA 

1923 AA TAX 

1924 68 PLA 

1925 28 PLP 

1926 4C 8B C3 JMP BASIC RETURN TO BASIC 

1930 ORG $1930 

MOVE VALUES INTO PAGE ZERO 

1930 A2 19 INIT LDXIM $19 MOVE 25. VALUES 

1932 BD 3A 19 LOAD LDAX DATA -01 

1935 95 1F STAZX $1F STORE IN PAGE ZERO 

1937 CA DEX 

1938 DO F8 BNE LOAD 
193A 60 RTS 

193B 00 DATA = $00 SCRL 

193C 80 = $80 SCRH 

19 3D 00 = $00 CHL 

193E 15 = $15 CHH 

193F 00 = $00 SCRLO 

1940 80 = $80 SCRHO 

1941 00 = $00 TEMPL 

1942 1B = $1B TEMPH 

1943 00 = $00 TEMPLO 

1944 1B = $1B TEMPHO 

1945 D7 = $D7 UP 

1946 28 = $28 DOWN 

1947 01 = $01 RIGHT 

1948 FE = $FE LEFT 

1949 D8 = $D8 UR 
194A D6 = $D6 UL 
194B 29 = $29 LR 
194C 27 = $27 LL 
194D 00 = $00 N 
194E E8 = $E8 SCRLL 
194F 83 = $83 SCRLH 

1950 00 = $00 RCSLO 

1951 15 = $15 RCSHO 

1952 00 = $00 TMP 

1953 00 = $00 TIMES 

1970 ORG $1970 

1970 20 A6 19 TMPSCR JSR RSTORE GET INIT ADDRESSES 

1973 B1 26 TSLOAD LDAIY TEMPL FETCH BYTE FROM TEMP 

1975 DO 06 BNE TSONE BRANCH IF NOT ZERO 

1977 A9 20 LDAIM BLANK BLANK SYMBOL 

1979 91 20 STAIY SCRL DUMP IT TO SCREEN 

197B DO 04 BNE TSNEXT 

197D A9 51 TSONE LDAIM DOT DOT SYMBOL 

197F 91 20 STAIY SCRL DUMP IT TO SCREEN 

1981 20 BD 19 TSNEXT JSR NXTADR FETCH NEXT ADDRESS 

1984 FO ED BEQ TSLOAD 
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1986 


20 


A6 19 




JSR 


RSTORE 


RESTORE INIT ADDRESSES 


1989 


60 






RTS 






198A 


20 


A6 19 


SCRTMP 


JSR 


RSTORE 


GET INIT ADDRESSES 


198D B1 


20 


STLOAD 


LDAIY 


SCRL 


READ DATA FROM SCREEN 


198F 


C9 


51 




CMPIM 


DOT 


TEST FOR DOT 


1991 


FO 


06 




BEQ 


STONE 


BRANCH IF DOT 


1993 


A9 


00 




LDAIM 


$00 


OTHERWISE ITS A BLANK 


1995 


91 


26 




STAIY 


TEMPL 


STORE IT 


1997 


FO 


01 




BEQ 


STNEXT 


UNCOND. BRANCH 


1999 


A9 


01 


STONE 


LDAIM 


$01 


A DOT WAS FOUND 


199B 


91 


26 




STAIY 


TEMPL 


STORE IT 


199D 


20 


BD 19 


STNEXT 


JSR 


NXTADR 


FETCH NEXT ADDRESS 


19A0 


FO 


EB 




BEQ 


STLOAD 




19A2 


20 


A6 19 




JSR 


RSTORE 


RESTORE INIT ADDRESSES 


19A5 


60 






RTS 






19A6 


A9 


00 


RSTORE 


LDAIM 


$00 


ZERO A, X, Y 


19A8 


AA 






TAX 






19A9 


A8 






TAY 






19AA 


85 


20 




STAZ 


SCRL 


INIT VALUES 


19AC 


85 


26 




STAZ 


TEMPL 




19AE 


85 


39 




STAZ 


RCSL 




19B0 


A5 


25 




LDAZ 


SCRHO 




19B2 


85 


21 




STAZ 


SCRH 




19B4 A5 


29 




LDAZ 


TEMPHO 




19B6 


85 


27 




STAZ 


TEMPH 




19B8 


A5 


36 




LDAZ 


RCSHO 




19BA 


85 


3A 




STAZ 


RCSH 




19BC 


60 






RTS 






19BD 


E6 


26 


NXTADR 


INCZ 


TEMPL 


GET NEXT LOW ORDER 


19BF 


E6 


20 




INCZ 


SCRL 


BYTE ADDRESS 


19C1 


E6 


39 




INCZ 


RCSL 




19C3 


E8 






INX 






19C4 


EM 


33 




CPXZ 


SCRLL 


IS IT THE LAST? 


19C6 


FO 


OC 




BEQ 


PAGECH 


IS IT THE LAST PAGE? 


19C8 


EO 


00 




CPXIM 


$00 


IS IT A PAGE BOUNDARY? 


19CA 


DO 


OE 




BNE 


NALOAD 


IF NOT, THEN NOT DONE 


19CC 


E6 


27 




INCZ 


TEMPH 


OTHERWISE ADVANCE TO 


19CE 


E6 


21 




INCZ 


SCRH 


NEXT PAGE 


19D0 


E6 


3A 




INCZ 


RCSH 




19D2 


DO 


06 




BNE 


NALOAD 


UNCONDITIONAL BRANCH 


19D4 


A5 


3*» 


PAGECH 


LDAZ 


SCRLH 


CHECK FOR LAST PAGE 


19D6 


C5 


21 




CMPZ 


SCRH 




19D8 FO 


03 




BEQ 


NADONE 


IF YES, THEN DONE 


19DA 


A9 


00 


NALOAD 


LDAIM 


$00 


RETURN WITH A=0 


19DC 


60 






RTS 






19DD 


A9 


01 


NADONE 


LDAIM 


$01 


RETURN WITH A=1 


19DF 


60 






RTS 







19E6 



ORG $19E6 



19E6 20 A6 19 
19E9 B1 26 
19EB DO 06 



TMPRCS JSR RSTORE INIT ADDRESSES 
TRLOAD LDAIY TEMPL FETCH DATA FROM TEMP 

BNE TRONE IF NOT ZERO THEN ITS ALIVE 
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19ED A9 


20 




LDAIM 


BLANK 


BLANK SYMBOL 


19EF 91 


39 




STAIY 


RCSL 


STORE IT IN SCREEN COPY 


19F1 DO 


04 




BNE 


NEWADR 


THEN ON TO A NEW ADDRESS 


19F3 A9 


51 


TRONE 


LD/SIM 


DOT 


THE DOT SYMBOL 


19F5 91 


39 




STAIY 


RCSL 


STORE IT IN SCREEN COPY 


19F7 20 


BD 19 


NEWADR 


JSR 


NXTADR 


FETCH NEXT ADDRESS 


19FA FO 


ED 




BEQ 


TRLOAD 


IF ArO, THEN NOT DONE 


19FC 20 


A6 19 




JSR 


RSTORE 


ELSE DONE. RESTORE 


19FF 60 






RTS 






1A00 20 


A6 19 


GENER 


JSR 


RSTORE 


INIT ADDRESSES 


1A03 20 


2F 1A 


AGAIN 


JSR 


NBRS 


FETCH NUMBER OF NEIGHBORS 


1A06 B1 


39 




LDAIY 


RCSL 


FETCH CURRENT DATA 


1A08 C9 


51 




CMPIM 


DOT 


IS IT A DOT? 


1A0A FO 


OC 




BEQ 


OCC 


IF YES, THEN BRANCH 


1A0C A5 


32 




LDAZ 


N 


OTHERWISE ITS BLANK 


1A0E C9 


03 




CMPIM 


$03 


SO WE CHECK FOR 


1A10 DO 


14 




BNE 


GENADR 


A BIRTH 


1A12 A9 


01 


BIRTH 


LDAIM 


$01 


IT GIVES BIRTH 


1A14 91 


26 




STAIY 


TEMPL 


STORE IT IN TEMP 


1A16 DO 


OE 




BNE 


GENADR 


INCONDITIONAL BRANCH 


1A18 A5 


32 


OCC 


LDAZ 


N 


FETCH NUMBER OF NEIGHBORS 


1A1A C9 


03 




CMPIM 


$03 


IF IT HAS 3 OR 2 


1A1C FO 


08 




BEQ 


GENADR 


NEIGHBORS IT SURVIVES 


1A1E C9 


02 




CMPIM $02 




1A20 FO 


04 




BEQ 


GENADR 




1A22 A9 


00 


DEATH 


LDAIM 


$00 


IT DIED! 


1A24 91 


26 




STAIY 


TEMPL 


STORE IT IN TEMP 


1A26 20 


BD 19 


GENADR 


JSR 


NXTADR 


FETCH NEXT ADDRESS 


1A29 FO 


D8 




BEQ 


AGAIN 


IF 0, THEN NOT DONE 


1A2B 20 


A6 19 




JSR 


RSTORE 


RESTORE INIT ADDRESSES 


1A2E 60 






RTS 






1A2F 98 




NBRS 


TYA 




SAVE Y AND X ON STACK 


1A30 48 






PHA 






1A31 8A 






TXA 






1A32 48 






PHA 






1A33 AO 


00 




LDYIM 


$00 


SET Y AND N = 


1A35 84 


32 




STYZ 


N 




1A37 A2 


08 




LDXIM $08 


CHECK 8 NEIGHBORS 


1A39 B5 


29 


OFFS 


LDAZX 


OFFSET 


-01 


1A3B 10 


15 




BPL 


ADD 


ADD IF OFFSET IS POSITIVE 


1A3D 49 


FF 




EORIM 


$FF 


OTHERWISE GET SET TO 


1A3F 85 


37 




STAZ 


TMP 


SUBTRACT 


1A41 38 






SEC 




SET CARRY BIT FOR SUBTRACT 


1A42 A5 


39 




LDAZ 


RCSL 




1A44 E5 


37 




SBCZ 


TMP 


SUBTRACT TO GET THE 


1A46 85 


22 




STAZ 


CHL 


CORRECT NEIGHBOR ADDRESS 


1A48 A5 


3A 




LDAZ 


RCSH 




1A4A 85 


23 




STAZ 


CHH 




1A4C BO 


11 




BCS 


EXAM 


OK, FIND OUT WHAT'S THERE 


1A4E C6 


23 




DECZ 


CHH 


PAGE CROSS 


1A50 DO 


OD 




BNE 


EXAM 


UNCOND. BRANCH 


1A52 18 




ADD 


CLC 




GET SET TO ADD 


1A53 65 


39 




ADCZ 


RCSL 


ADD 


1A55 85 


22 




STAZ 


CHL 


STORE THE LOW PART 
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1A57 A5 3A 




LDAZ 


RCSH 


FETCH THE HIGH PART 


1A59 85 23 




STAZ 


CHH 




1A5B 90 02 




BCC 


EXAM 


OK, WHAT'S THERE 


1A5D E6 23 




INCZ 


CHH 


PAGE CROSSING 


1A5F B1 22 


EXAM 


LDAIY 


CHL 


FETCH THE NEIGHBOR 


1A61 C9 51 




CMPIM 


DOT 


DATA BYTE AND SEE IF ITS 


1A63 DO 02 




BNE 


NEXT 


OCCUPIED 


1A65 E6 32 




INCZ 


N 


ACCUMULATE NUMBER OF NEIGHBORS 


1A67 CA 


NEXT 


DEX 






1A68 DO CF 




BNE 


OFFS 


NOT DONE 


1A6A 68 




PLA 




RESTORE X, Y FROM STACK 


1A6B AA 




TAX 






1A6C 68 




PLA 






1A6D A8 




TAY 






1A6E 60 




RTS 







SYMBOL 


TABLE 


2000 2186 










BLANK 


0020 


SCRL 


0020 


SCRH 


0021 


CHL 


0022 


CHH 


0023 


SCRLO 


0024 


SCRHO 


0025 


TEMPL 


0026 


TEMPH 


0027 


TEMPLO 


0028 


TEMPHO 


0029 


OFFSET 


002A 


UP 


002A 


DOWN 


002B 


RIGHT 


002C 


LEFT 


002D 


UR 


002E 


UL 


002F 


LR 


0030 


LL 


0031 


N 


0032 


SCRLL 


0033 


SCRLH 


0034 


RCSLO 


0035 


RCSHO 


0036 


TMP 


0037 


TIMES 


0038 


RCSL 


0039 


RCSH 


003A 


DOT 


0051 


LIFE 


1900 


MAIN 


1900 


GEN 


1910 


INIT 


1930 


LOAD 


1932 


DATA 


193B 


TMPSCR 


1970 


TSLOAD 


1973 


TSONE 


197D 


TSNEXT 


1981 


SCRTMP 


198A 


STLOAD 


198D 


STONE 


1999 


STNEXT 


199D 


RSTORE 


19A6 


NXTADR 


19BD 


PAGECH 


19D4 


NALOAD 


19DA 


NADONE 


19DD 


TMPRCS 


19E6 


TRLOAD 


19E9 


TRONE 


19F3 


NEWADR 


19F7 


GENER 


1A00 


AGAIN 


1A03 


BIRTH 


1A12 


OCC 


1A18 


DEATH 


1A22 


GENADR 


1A26 


NBRS 


1A2F 


OFFS 


1A39 


ADD 


1A52 


EXAM 


1A5F 


NEXT 


1A67 


BASIC 


C38B 














SYMBOL 


TABLE 


2000 2186 










ADD 


1A52 


AGAIN 


1A03 


BASIC 


C38B 


BIRTH 


1A12 


BLANK 


0020 


CHH 


0023 


CHL 


0022 


DATA 


193B 


DEATH 


1A22 


DOT 


0051 


DOWN 


002B 


EXAM 


1A5F 


GENADR 


1A26 


GENER 


1A00 


GEN 


1910 


INIT 


1930 


LEFT 


002D 


LIFE 


1900 


LL 


0031 


LOAD 


1932 


LR 


0030 


MAIN 


1900 


N 


0032 


NADONE 


19DD 


NALOAD 


19DA 


NBRS 


1A2F 


NEWADR 


19F7 


NEXT 


1A67 


NXTADR 


19BD 


OCC 


1A18 


OFFS 


1A39 


OFFSET 


002A 


PAGECH 


19D4 


RCSH 


003A 


RCSHO 


0036 


RCSL 


0039 


RCSLO 


0035 


RIGHT 


002C 


RSTORE 


19A6 


SCRH 


0021 


SCRHO 


0025 


SCRL 


0020 


SCRLH 


0034 


SCRLL 


0033 


SCRLO 


0024 


SCRTMP 


198A 


STLOAD 


198D 


STNEXT 


199D 


STONE 


1999 


TEMPH 


0027 


TEMPHO 


0029 


TEMPL 


0026 


TEMPLO 


0028 


TIMES 


0038 


TMPRCS 


19E6 


TMPSCR 


1970 


TMP 


0037 


TRLOAD 


19E9 


TRONE 


19F3 


TSLOAD 


1973 


TSNEXT 


1981 


TSONE 


197D 


UL 


002F 


UP 


002A 


UR 


002E 
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k SIMPLE 6502 ASSEMBLER FOR THE PET 

Michael 3. McCsnn 
28 Ravenswood Terrace 
Cheektowaga, NY 14225 



Most computer hobbyists do all or most of their 
programming in BASIC. This is unfortunate since 
there is much to be gained from machine code 
level programming . On the average , machine lan- 
guage programs are 100 times faster than their 
BASIC equivalents. In addition, machine lang- 
uage programs are very compact , making efficient 
use of memory. I have written a simple 6502 
assembler in Commodore BASIC (see listing) with 
the following functions: 

1 . Input source code and assemble 

2. Save object code on tape 

3. Load object code from tape 

4. Run machine language program with SYS 

5. Run machine language program with USB 

6. List machine language program 

INPUT SOURCE CODE AND ASSEMBLE 

-Symbolic addresses and operands are not per- 
mitted 
-All addresses and operands must be supplied 

in base 10 
-Each line of source code is assembled after 

entry 
-Source code is inputted in the following 

format : 

(mnemonic) (one or more spaces) (operand) 
-Three pseudoinstruc t ions are supported 

ORG-Start with this address 

NOTE: if the user does not specify the origin, 
it will be set at 826 base 10 

DC-Define constant , place the operand value 
in the next location in memory 

END-End of program source code 

SAVE OBJECT CODE ON TAPE 

-Object code saved under file name supplied by 

user 
-Origin address saved with program 

LOAD OBJECT CODE FROM TAPE 

-Loads object program under file name supplied 

by user 
-Object code is stored in memory with the same 

origin address used when the program was 

assembled 

RUN MACHINE LANGUAGE PROGRAM WITH SYS 
-Transfers control of the 6502 to an address 
supplied by the user 

RUN MACHINE LANGUAGE PROGRAM WITH USR 
-Transfers a user supplied value to the 

6502 accumulator 
-Transfers control of the 6502 to an address 

supplied by the user 

LIST MACHINE LANGUAGE PROGRAM 

-Listing is produced by disassembling object 

code 
-Disassembly is in the following format: 

(decimal address) (hexadecimal address) (byte#1 ) 

( byte#2 ) ( byte#3 ) (mnemonic ) ( operand ) 

The following areas of memory are available for 
your machine language programs when this assem- 
bler is in memory: locations 7884-8184 and, if 
tape #2 is not used, locations 826-1024. 



There are two ways of returning control to BASIC 
from machine language. The RTS (Return from 
Subroutine) instruction may be used at any time 
°<:cept when in a user machine language subrou- 
tine. RTS returns control to the calling BASIC 
program. In contrast the BRK (Force Break) in- 
struction does not return control to the calling 
BASIC program; instead control is returned 
to the user, i.e. system prints READY with the 
cursor. 

I have included a short machine language pro- 
gram. When run this program will leave a pat- 
tern of small white dots on the upper half of 
PET's CRT. 



SAMPLE MACHINE LANGUAGE PROGRAM LISTING 



826 033A 


A9 66 


LDAIM 


102 


828 033C 


A2 00 


LDXIM 





830 033E 


9D 00 80 


STAX 


32768 


833 0341 


E8 


INX 




834 0342 


F0 03 


BEQ 


3 


836 0344 


4C 3E 03 


JMP 


830 


839 0347 


EA 


NOP 




840 0348 


EA 


NOP 




841 0349 


9D 00 81 


STAX 


33024 


844 034C 


E8 


INX 




845 034D 


F0 03 


BEQ 


3 


847 034F 


4C 49 03 


JMP 


841 


850 0352 


00 


BRK 





SAMPLE MACHINE LANGUAGE PROGRAM 
AS INPUTTED FROM THE KEYBOARD 



ORG 826 

LDAIM 102 

LDXIM 

STAX 32768 

INX 

BEQ 3 

JMP 830 

NOP 

NOP 

STAX 33024 

INX 

BEQ 3 

JMP 841 

BRK 

END 



Two additional thoughts before you start: 

1 . After entering the program from the 
keyboard you must save it on tape before going 
through "RUN" again. If you don't EN and ZZ are 
set to zero . 

2. When using the "BRK" command the system out- 
puts the error statement "ILLEGAL QUANTITY 
ERROR IN 10020", READY. 
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1 REM 6502 ASSEMBLER PROGRAM 

2 REM BY MICHAEL J. MCCANN 

3 REM FOR USE ON THE COMMODORE PET 
10 DIM MN$(256),BY%(256),C0$(16) 
2,0 FOR E=0 TO 255 

30 READ MN$(E),BY$(E) 

40 NEXT 

60 FOR E=0 TO 15 

70 READ CO$(E) 

80 NEXT 

90 PRINT CHR$( 147): PRINT 

100 PRINT" 1 -INPUT SOURCE CODE AND ASSEMBLE" : PRINT 

110 PRINT"2-SAVE OBJECT CODE ON TAPE": PRINT 

120 PRINT" 3-LOAD OBJECT CODE FROM TAPE": PRINT 

130 PRINT"4-RUN MACHINE LANGUAGE PROGRAM WITH SYS" 

140 PRINT"5-RUN MACHINE LANGUAGE PROGRAM WITH USR" 

150 PRINT"6-LIST MACHINE LANGUAGE PROGRAM" 

180 GET A$:IF A$="" GOTO 180 

190 IF VAL(A$)=0 OR VAL(A$)>6 GOTO 180 

200 ON VAL(A$) GOSUB 14000,20000,9000,10000,11000,2900 

210 GOTO 90 

1000 SX=INT(DC/16) 

1010 UN=DC-(SX*16J 

1020 SX$=C0$(SX) 

1030 UN$=CO$(UN) 

1040 HX$=SX$+UN$ 

1050 RETURN 

2900 PRINT CHR$(147) 

2910 INPUT" START ADDRESS" ; AD: 1=0 

3000 IF 1=24 GOTO 5050 

3001 1=1+1 

3005 IB=PEEK(AD) 

3015 IF MN$(IB)<>"NULL" GOTO 3050 

3025 DC= IB: GOSUB 1000: GOSUB 13000 

3030 PRINT AD;AD$ TAB(12) HX$ "*" 

3040 AD=AD+1:G0T0 3000 

3050 ON BY$(IB) GOTO 3060,3090,4050 

3060 DC=IB: GOSUB 1000: GOSUB 13000 

3070 PRINT AD;AD$ TAB( 12) ;HX$;TAB(21 ) ;MN$(IB) 

3075 AD=AD+1 

3080 GOTO 5030 

3090 DC=IB: GOSUB 1000 

4000 B1$=HX$ 

4010 DC= PEEK (AD+1): GOSUB 1000 

4011 B2$=HX$ 

4024 GOSUB 13000:P=DC 

4030 PRINT AD;AD$ TAB( 12) ;B1$;" ";B2$;TAB(21 ) ;MN$(IB) ; TAB(27) ;I 

4035 AD=AD+2 

4040 GOTO 5030 

4050 DC= IB: GOSUB 1000 

4060 B1$=HX$ 

4070 DC= PEEK (AD+1): GOSUB 1000 

4080 B2$=HX$ 

4090 DC= PEEK ( AD+2 ): GOSUB 1000 
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5000 B3$=HX$ 

5010 0P=PEEK(AD+1)+(PEEK(AD+2)«256) 

5011 GOSUB 13000 

5020 PRINT AD;AD$ TAB( 12) ;B1$;" ";B2$;" »';B3$;TAB(21) ;MN$(IB) ;TAB(27) ;0P 

5025 AD=AD+3 

5030 GOTO 3000 

5050 GET A$:IF A$="" GOTO 5050 

5051 IF A$=CHR$(19) THEN 1=0: RETURN 

5052 IF A$OCHR$(13) GOTO 5050 
5070 I=0:PRINT CHR$(147) 

5080 GOTO 3000 

6000 DATA BRK,1,0RAIX,2,NULL,0,NULL,0,NULL,0,0RAZ,2,ASL,2,NULL,0,PHP,1 

6010 DATA ORAIM,2,ASLA,1,NULL,0,NULL,0,ORA,3,ASL.3,NULL,0.BPL.2.ORAIY.2 

6020 DATA NULL , , NULL , , NULL , , ORAZX , 2 , ASLZX , 2 , NULL , , CLC , 1 , ORAY ,3 

6030 DATA NULL,0,NULL,0,NULL,O,ORAX,3,ASLX,3,NULL,O, JSR,3,ANDIX,2,NULL,0 

6040 DATA NULL,0,BITZ,2,ANDZ,2,ROLZ,2,NULL,0,PLP, 1 ,ANDIM,2,R0LA, 1 ,NULL,0 

6050 DATA BIT,3,AND,3,R0L,3,NULL,0,BMI,2,ANDIY,2,NULL,0,NULL,0,NULL,0 

6060 DATA ANDZX,2,ROLZX,2,NULL,0,SEC, 1 ,ANDY,3,NULL,0,NULL,0, NULL , , ANDX , 3 

6070 DATA ROLX , 3 , NULL , , RTI , 1 , EORIX , 2 , NULL , , NULL , , NULL ,0 , EORZ , 2 , LSRZ , 2 

6080 DATA NULL,0,PHA, 1 ,E0RIM,2,LSRA, 1 ,NULL,0, JMP,3,E0R,3,LSR,3,NULL,0 

6090 DATA BVC,2,EORIY,2,NULL,0,NULL,0,NULL,0,EORZX,2,LSRZX,2,NULL,0 

6100 DATA CLI,1,E0RY,3,NULL,0,NULL,0,NULL,0,E0RX,3,LSRX,3,NULL,0,RTS,1 

6110 DATA ADCIX,2,NULL,0,NULL,0,NULL,0,ADCZ,2,R0RZ,2,NULL,0,PLA,1,ADCIM,2 

6120 DATA R0RA,1 ,NULL,0,JMPI,3,ADC,3,R0R,3,NULL,0,BVS,2,ADCIY,2,NULL,0 

6130 DATA NULL,0,NULL,0,ADCZX,2,R0RZX,2,NULL,0,SEI,1,ADCY,3,NULL,0,NULL,0 

6140 DATA NULL,0,ADCX,3,RORX,3,NULL,0,NULL,0,STAIX,2,NULL,0,NULL,0,STYZ,2 

6150 DATA STAZ,2,STXZ,2,NULL,0,DEY,1,NULL,0,TXA,1,NULL,0,STY,3,STA,3 

6160 DATA STX,3,NULL,0,BCC,2,STAIY,2,NULL,0,NULL,0,STYZX,2,STAZX,2,STXZY,2 

6170 DATA NULL, 0,TYA,1, STAY, 3.TXS.1, NULL, 0, NULL, 0,STAX, 3, NULL, 0, NULL, 

6180 DATA LDYIM,2,LDAIX,2,LDXIM,2,NULL,0,LDYZ,2,LDAZ,2,LDXZ,2,NULL,0 

6190 DATA TAY,1,LDAIM,2,TAX,1,NULL,0,LDY,3,LDA,3,LDX,3,NULL,0,BCS,2 

6200 DATA LDAIY , 2 , NULL , , NULL , , LDYZX , 2 , LDAZX , 2 , LDXZY , 2 , NULL , , CLV , 1 

6210 DATA LDAY,3,TSX,1,NULL,0,LDYX,3,LDAX,3,LDXY,3,NULL,0,CPYIM,2,CMPIX,2 

6220 DATA NULL,0,NULL,0,CPYZ,2,CMPZ,2,DECZ,2,NULL,0,INY, 1 ,CMPIM,2,DEX, 1 

6230 DATA NULL,0,CPY,3,CMP,3,DEC,3,NULL,0,BNE,2,CMPIY,2,NULL,0,NULL,0 

6240 DATA NULL,0,CMPZX,2,DECZX,2,NULL,0,CLD, 1 , CMPY, 3, NULL, 0, NULL, 0, NULL, 

6250 DATA CMPX,3,DECX,3,NULL,0,CPXIM,2,SBCIX,2,NULL,0,NULL,0, CPXZ,2,SBCZ,2 

6260 DATA INCZ,2,NULL,0,INX, 1 , SBCTM , 2 , NOP , 1 ,NULL,0,CPX,3,SBC,3,INC,3 

6270 DATA NULL,0,BEQ,2,SBCIY,2,NULL,0,NULL,0,NULL,0,SBCZX,2,INCZX,2,NULL,0,SED, 1 

6280 DATA SBCY,3,NULL,0,NULL,0,NULL,0,SBCX,3,INCX,3,NULL,0 

6290 DATA 0, 1 ,2,3,4,5,6,7,8,9,A,B,C,D,E,F 

9000 PRINT CHR$(147) 

9010 INPUT "ENTER FILE NAME";N$ 

9020 OPEN 1,1,0,N$ 

9030 INPUT* 1,ZZ 

9040 INPUT* 1, EN 

9050 FOR AD=ZZ TO EN 

9060 INPUT* 1,DA$ 

9070 POKE AD.DAJ 

9080 NEXT 

9090 CLOSE 1 

9100 RETURN 
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10000 PRINT CHR$(147) 

10010 INPUT "ENTER ADDRESS IN BASE 10"; AD 

10015 IF AD>65535 GOTO 10000 

10020 SYS(AD) 

10030 RETURN 

11000 PRINT CHR$(147) 

11010 INPUT" ENTER ACCUMULATOR VALUE"; AC 

11015 IF AC<0 OR AC>255 GOTO 11010 

11020 INPUT"ENTER ADDRESS IN BASE 10"; AD 

11030 POKE 2, INT( AD/256) 

11040 POKE 1,AD-(INT(AD/256)*256) 

11050 X=USR(AC) 

11060 RETURN 

13000 A=AD:S3=INT( AD/4096) 

13002 A=A-S3*4096 

13010 S2=INT(A/256) 

13012 A=A-S2*256 

13020 S=INT(A/16) 

13060 U=AD-(S3*4096+S2*256+S«16) 

13070 S3$=C0$(S3) 

13080 S2$=C0$(S2) 

13090 S$=C0$(S) 

13100 U$=CO$(U) 

13110 AD$=S3$+S2$+S$+U$ 

13120 RETURN 

14000 PRINT CHR$(147):AD=826:ZZ=826 

14010 PRINT "(MNEMONIC) (SPACE) (OPERAND)" 

14020 GOSUB 15000 

14030 F=0 

14040 FOR E=0 TO 255 

14050 IF MN$=MN$(E) THEN BY=BY$(E) :F=1 :CD=E:E=256 

14060 NEXT 

14070 IF F=0 GOTO 14260 

14080 ON BY GOSUB 14100, 14130, 14180 

14090 GOTO 14020 

14100 POKE AD, CD 

14110 AD=AD+1 

14120 RETURN 

14130 IF 0P>255 OR 0P<0 THEN PRINT "ERROR" : RETURN 

14140 POKE AD, CD 

14150 POKE AD+1.0P 

14160 AD=AD+2 

14170 RETURN 

14180 IF 0P>65535 OR 0P<0 THEN PRINT "ERROR" : RETURN 

14190 POKE AD, CD 

14200 B2=INT(0P/256) 

14210 B1=0P-(B2«256) 

14220 POKE AD+1.B1 

14230 POKE AD+2,B2 

14240 AD=AD+3 

14250 RETURN 

14260 IF MN$="0RG" OR MN$="END" OR MN$="DC" GOTO 14280 

14270 PRINT "ERROR": GOTO 14020 

14280 IF MN$="ORG" GOTO 14300 

14290 GOTO 14340 

14300 IF F0=1 THEN PRINT "ERROR" :G0T0 14020 

14310 F0=1 

14320 AD=0P:ZZ=0P 

14330 GOTO 14020 
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14340 IF MN$="END" GOTO 14360 

14350 GOTO 14480 

14360 EN=AD-1 

14370 RETURN 

14480 POKE AD, OP 

14510 AD=AD+1 

14520 GOTO 14020 

15000 INPUT A$ 

15010 IF LEN(A$)<3 THEN PRINT "ERROR" :G0T0 15000 

15020 IF LEN(A$)=3 THEN MN$ A$:OP=0 : RETURN 

15030 S=0:F0R M=1 TO LEN(A$) 

15040 IF MID$(A$,M,1)=" » THEN S=M:M=LEN(A$) 

1 5050 NEXT 

15060 IF S=0 THEN MN$=A$: RETURN 

15070 MN$=LEFT$(A$,S-1) 

1 5080 OP=VAL( RIGHT$ ( A$ , LEN( A$ ) -S) ) 

15090 RETURN 

20000 PRINT CHR$(147):SZ=0 

20010 INPUT "ENTER PROGRAM NAME";N$ 

20020 OPEN 1,1,1,N$ 

20030 PRINT* 1,ZZ:DA$=ZZ:GOSUB 20110 

20040 PRINT* 1, EN :DA$=EN:GOSUB 20110 

20050 FOR AD=ZZ TO EN 

20060 DA$=PEEK(AD) 

20070 PRINT* 1,DA$:GOSUB 20110 

20080 NEXT 

20090 CLOSE 1 

20100 RETURN 

20110 SZ=LEN(STR$(DA*))+SZ+1 

20120 IF SZ<192 THEN RETURN 

20130 POKE 59411,53 

20140 T=TI 

20150 IF (TI-TX6 GOTO 20150 

20160 POKE 59411,61 

20170 SZ=SZ-191 

20180 RETURN 
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A BASIC 6502 DISASSEMBLER 
FOR APPLE AND PET 

Michael J. McCann 
28 Ravenswood Terrace 
Cheektowaga, NY 14225 



A disassembler is a program that ac- 
cepts machine language (object code) as 
input and produces a symbolic represen- 
tation that resembles an assembler 
listing. Although disassemblers have a 
major disadvantage viz., that they can- 
not reproduce the labels used by the 
original programmer, they can prove 
very useful when one is attempting to 
transplant machine code programs from 
one 6502 system to another. This ar- 
ticle describes a disassembler program 
written in Commodore BASIC. 

The disassembler (see listing and sam- 
ple run) uses the mnemonics listed in 
the "Best of MICRO", on page 176A. The 
output is in this format: (address) 
(byte#1) (byte#2) (byte#3) (mnemonic) 
(bytes #2 and #3) 

The address is outputted in decimal 
(base 10). The contents of the byte(s) 
making up each instruction are printed 
in hexadecimal (base 16) between the 
address and the mnemonic. In three 
byte instructions the high order byte 
is multiplied by 256 and added to the 
contents of the low order byte, giving 
the decimal equivalent of the absolute 
address. This number is printed in the 
(bytes #2 and #3) field. In two byte 
instructions the decimal equivalent of 
the second byte is printed in the 
(bytes #2 and #3) field. 



Programming Comments 

Lines 10-40 initialize the BY% and MN$ 
arrays (BY% contains the number of 
bytes in each instruction and MN$ con- 
tains the mnemonic of each instruction) 

Lines 60-80 initialize the decimal to 
hexadecimal conversion array (C0$) 

Lines 100-130 input the starting ad- 
dress 

Lines 1000-1050 decimal to hexadecimal 
conversion subroutine 

Lines 3000-5030 do the disassembly 

Lines 3010-3030 take care of illegal 
operation codes 

Line 3050 transfers control to one of 
three disassembly routines, the choice 
is determined by the number of bytes in 
the instruction 

Lines 6000-6290 contain the data for 
the arrays 

Although this was originally written in 
Commodore BASIC, it will work with the 
APPLESOFT BASIC of the APPLE computer. 



SAMPLE RUN 
RUN 

START ADDRESS 
? 64004 

64004 4C 7E E6 JMP 59006 
64007 AD 0A 02 LDA 522 
64010 F0 08 BEQ 8 
64012 30 04 BMI 4 
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1 REM A 6502 DISASSEMBLER 

2 REM EY MICHAEL J. KCCANN 

? REM WILL RUN ON AN 8K PET OR AN APPLE WITH APPLESOFT BASIC 

10 DIM MN$(256)BY$(256),C0$(16) 

20 FOR E=0 TO 255 

30 READ MN$(E),BY*(E) 

40 NEXT E 

60 FOR E=0 TO 15 

70 READ CO$(E) 

80 NEXT E 

100 PRINT CHR$(147) 

110 PRINT: PRINT "START ADDRESS" 

120 INPUT AD 

130 PRINT 

140 1=0 

150 GOTO 3000 

1000 SX=INT(DC/16) Note: The two PRINT statements with 

1010 UN=DC-(SX*16) an * are required by APPLESOFT to 

1020 SX$=CO$(SX) prevent the first output line from 

1030 UN$=CO$(UN) being mis-aligned. They may not be 

1040 HX$=SX$+UN$ required by the PET BASIC. 

1050 RETURN 

3000 IF 1=16 THEN 5050 

3005 1=1+1 

3010 IB=PEEK(AD) 

3015 IF MN$(IB)<>"NULL" GOTO 3050 

3020 DC=IB:GOSUB 1000 

3030 PRINT AD;TAB(8);HX$;"»" 

3035 AD=AD+1 

3040 GOTO 5030 

3050 ON BYSKIB) GOTO 3060,3090,4050 

3060 DC=IB:GOSUB 1000 

3070 PRINT AD;TAB(8);HX$;TAB(17);MN$(IB) 

3075 AD=AD+1 

3080 GOTO 5030 

3090 DC=IB:GOSUB 1000 

4000 B1$=HX$ 

4010 DC=PEEK(AD+1):GOSUB 1000 

4020 B2$=HX$ 

4030 PRINT AD;TAB(8);B1$;" ";B2$;TAB( 17) ;MN$(IB) ;TAB(21) ;PEEK(AD+1) 

4035 AD=AD+2 

4040 GOTO 5030 

4050 DC=IB:GOSUB 1000 

4060 B1$=HX$ 

4070 DC=PEEK(AD+1):GOSUB 1000 

4080 B2$=HX$ 

4090 DC=PEEK(AD+2):GOSUB 1000 

5000 B3$=HX$ 

5010 OP=PEEK(AD+1)+(PEEK(AD+2)*256) 

5020 PRINT AD;TAB(8);B1$;»» ";E2$;" " ;B3$;TAB( 17) ;MN$(IB) ;TAB(21) ;OP 

5025 AD=AD+3 

5030 GOTO 3000 

5050 INPUT A 

5060 PRINT 

5070 1=0 

5080 GOTO 3000 
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6000 DATA BRK,1,ORAIX,2,NULL,0,NULL,0,NULL,0,ORAZ,2,ASLZ,2,NULL,0,PHP,1 

6010 DATA 0RAIM,2,ASLA,1,NULL,0,NULL,0,0RA,3,ASL,3,NULL,0,BPL,2,0RAIY,2 

6020 DATA NULL, 0, NULL, 0, NULL, 0.ORAZX, 2, ASLZX,2,NULL,0,CLC, 1 ,0RAY,3 

6030 DATA NULL,0,NULL,0,NULL,0,ORAX,3,ASLX,3,NULL,0,JSR,3,ANDIX,2,NULL,O 

60M0 DATA NULL,0,BITZ,2,ANDZ,2,R0LZ,2,NULL,0,PLP, 1 ,ANDIM,2,R0LA, 1 ,NULL,0 

6050 DATA BIT,3,AND,3,ROL,3,NULL,0,BMI,2,ANDIY,2,NULL,0,NULL,O,NULL,0 

6060 DATA ANDZX,2,ROLZX,2,NULL,0,SEC, 1 ,ANDY,3,NULL,0,NULL,0,NULL,0, ANDX.3 

6070 DATA R0LX,3,NULL,0,RTI, 1 ,EORIX,2,NULL,0,NULL,0,NULL,0,EORZ,2,LSRZ,2 

6080 DATA NULL,0,PHA, 1 ,E0RIM,2,LSRA, 1 ,NULL,0, JMP,3,EOR,3,LSR,3,NULL,0 

6090 DATA BVC , 2 , EORIY , 2 , NULL , , NULL , , NULL , , EORZX , 2 , LSRZX , 2 , NULL , 

6100 DATA CLI,1,EORY,3,NULL,0,NULL,0,NULL,0,EORX,3,LSRX,3,NULL,0,RTS,1 

6110 DATA ADCIX,2,NULL,0,NULL,O f NULL,0,ADCZ,2,RORZ,2,NULL,0,PLA,1,ADCIM,2 

6120 DATA RORA,1,NULL,0,JMPI,3,ADC,3,ROR,3,NULL,0,BVS,2,ADCIY,2,NULL,0 

6130 DATA NULL,0,NULL,0,ADCZX,2,R0RZX,2,NULL,0,SEI,1,ADCY,3,NULL,0,NULL,0 

6140 DATA NULL,0,ADCX,3,RORX,3,NULL,0,NULL,0,STAIX,2,NULL,0,NULL,0,STYZ,2 

6150 DATA STAZ,2,STXZ,2,NULL,0,DEY,1,NULL,0,TXA,1,NULL,0,STY,3,STA,3 

6160 DATA STX,3,NULL,0,BCC,2,STAIY,2,NULL,0,NULL,0,STYZX,2,STAZX,2,STXZY,2 

6170 DATA NULL, 0,TYA,1, STAY, 3, TXS.1, NULL, 0, NULL, O.STAX, 3, NULL, 0, NULL, 

6 1 80 DATA LDYIM , 2 , LDAIX , 2 , LDXIM ,2 , NULL , , LDYZ , 2 , LDAZ , 2 , LDXZ , 2 , NULL , 

6190 DATA TAY,1,LDAIM,2,TAX,1,NULL,0,LDY,3,LDA,3,LDX,3,NULL,0,BCS,2 

6200 DATA LDAIY , 2 , NULL , , NULL , , LDYZX , 2 , LDAZX , 2 , LDXZY , 2 , NULL , , CLV , 1 

6210 DATA LDAY,3,TSX,1,NULL,0,LDYX,3,LDAX,3,LDXY,3,NULL,0,CPYIM,2,CMPIX,2 

6220 DATA NULL,0,NULL,0,CPYZ,2,CMPZ,2,DECZ,2,NULL,0,INY, 1 ,CMPIM,2,DEX, 1 

6230 DATA NULL,0,CPY,3,CMP,3,DEC,3,NULL,0,BNE,2,CMPIY,2,NULL,0,NULL,0 

6240 DATA NULL,0,CMPZX,2,DECZX,2,NULL,0,CLD,1,CMPY,3,NULL,0,NULL,0,NULL,0 

6250 DATA CMPX,3,DECX,3,NULL,0,CPXIM,2,SBCIX,2,NULL,0,NULL,0, CPXZ,2,SBCZ,2 

6260 DATA INCZ,2,NULL,0,INX, 1 ,SBCIM,2,N0P, 1 ,NULL,0,CPX,3,SBC,3,INC,3 

6270 DATA NULL,0,BEQ,2,SBCIY,2,NULL,0,NULL,0,NULL,0,SBCZX,2,INCZX,2,NULL,0,SED, 1 

6280 DATA SBCY,3,NULL,0,NULL,0,NULL,0,SBCX,3,INCX,3,NULL,0 

6290 DATA 0, 1 ,2,3,4,5,6,7,8,9 , A, B,C,D,E,F 
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INSIDE THE APPLE II 

Arthur Ferruzzi 
69 Hauman Street 
Revere, MA 02151 



If you've seen the colorful Apple II ads, you 
know that this is a fun machine. However, with 
a typical system price roughly equal to a trip 
to Europe , I suspect that the real computer nuts 
are going to let the wife and kids "byte" into 
the fun features while they make use of the 
Apple's extensive software and hardware power. 
Let's look at the Apple II as a complete, yet 
easily expandable, system on a board. 

There's Memory 

There are three rows of RAM memory sockets, each 
of which will hold 4K or 16K bytes of dynamic 
RAM for a maximum of 48K bytes of RAM. There 
are six sockets each of which will hold 2K of 
ROM. Four ROMs are supplied, containing a 6K 
integer BASIC and a 2K System Monitor. The full 
feature System Monitor supports commands that 
examine and deposit data into memory, move and 
compare blocks of memory, load and store blocks 
on cassette , assemble and disassemble op codes , 
run trace and single step programs, display and 
modify 6502 registers, and perform hexadecimal 
arithmetic. In addition, the monitor is chock 
full of user accessible subroutines including a 
floating point package and simulated 16 bit 
microprocessor . 

One of the more interesting possibilities for 
the Apple II is expansion of the software in 
ROM. The 8K supplied is in 2K byte 9316B ROM 
chips. A check of the pinouts shows that these 
ROMs are nearly identical to the 2716/2708 
EPROM. Check the manual at your nearest Apple 
dealer before you burn in your favorite version 
of PASCAL, APL, or ANIMATION. 

There's Video 

The second 1K block of memory is shared by the 
processor (during phase 2 of the clock) and the 
display (during phase 1 of the clock, when it is 
also refreshing every dynamic RAM chip on the 
board). Thus, the display is fast, and it is 
colorful. Options are 24 lines of 40 upper case 
characters, or 40 x 40 graphics in 15 colors 
plus four lines of text, or 40 x 48 graphics in 
15 colors. Colors, point plotting and line 
plotting are also accessible from BASIC. With 
an 8K chunk of memory, you have high resolution 
280 horizontal by- 192 vertical graphics in four 
colors, or 32 fewer vertical lines with four 
lines of text at the bottom of the screen. The 
speed of the video display and the 6502 itself 
as well as the machine language subroutines in 
the monitor and available on cassette tape make 
the 8K graphics extremely useful. 

There's I/O 

First , of course , is a full typewriter style 
ASCII keyboard and a 1500 bits per second cass- 
ette interface. But these are only the obvious 
I/O devices. In addition there are four 8 bit 
analog inputs which measure resistance by timing 
a variable delay generator. Normally set up as 
four game paddles, you might set them up as two 
joysticks to control the parameters in an inter- 
active system which provides feedback via the 
display. Before considering some of the 1/0 



possibilities, it is worth noting that the Apple 
II has a lot of address decoding done directly 
on the board. For example, writing to the eight 
addresses C058 — C05F sets or clears four TTL 
output lines. Reading from addresses C061— C063 
tests three switch inputs . Further , . keyboard 
input and strobe , cassette input and output , 
speaker output , paddle timers, and eight "soft- 
ware switches" which set the graphics and text 
modes, are all accessible by reading and writing 
specific memory locations . Thus , all ports may 
be set or tested by user programs including BAS- 
IC (peek and poke). 

If you want to expand the system, there are 
eight peripheral connectors on a 50 pin (x .10") 
fully buffered bus. Accessing any address in 
the range C800 — CFFF sends an I/O strobe to pin 
20 on all cards (0 through 7). Accessing add- 
resses C1xx — C7xx sends an I/O select pulse to 
pin 1 on the appropriate cards (1 through 7). 
Accessing addresses C08x — COFx sends a device 
select pulse to pin 41 on the appropriate card 
(0 through 7). Thus, the 8 peripheral cards are 
fully decoded, saving the overhead of address 
decoding logic . Provision is made for daisy- 
chained interrupt and DMA. Presumably Apple 
will be supplying low cost peripherals making 
use of these features. 

There's the Power Supply 

While the peripheral bus makes it easy to design 
custom I/O devices, the major limitation appears 
to be the power supply. It is a switching type 
supply where the AC is rectified and sent to an 
oscillator whose frequency varies with the load 
so that the +5 volt DC line is never more than 
3% off. The other voltages basically respond to 
the loading on the +5 volt line and are not as 
well regulated. I/O cards should draw less than 
1.5 watts and the power cord MUST BE VERY WELL 
GROUNDED. 

The Bottom Line 

In terms of serious applications, here is what 
you get: a fast 6502 microprocessor with all of 
its inherent features, 4 to 48K of RAM, a fast 
6K integer BASIC in ROM, a classy 2K System Mon- 
itor in ROM, a "transparent" 1K color video with 
graphics, 8K color graphics, an ASCII keyboard 
with interface , four analog inputs , a fast cass- 
ette interface , three digital I/O bits , an audio 
"beeper" , eight decoded peripheral connectors , a 
stylish package, and a (small) power supply. 

Just add up what all that good stuff costs sepa- 
rately. Then, if your application falls within 
or near these specifications, the Apple II will 
be a better buy than a homebrew system. In 
shopping for a computer , remember to try before 
you buy, from a reputable dealer. The Apple II 
is up and running at many computer stores a- 
cross the country. (For the dealer nearest you 
see the dealer list on page 16 of the October 
1977 issue of BYTE, or write . to Apple Computer 
Inc . , 20863 Stevens Creek Boulevard , Cupertino , 
CA 95014.} With a little savvy and careful 
picking, we can have the fine products we want 
and put the squeeze on the lemons. 
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A MORM IN THE APPLE? 

Mike Rowe 

P.O. Box 3 

5. Chelmsford, MA 01824 



There may be a serious problem hidden 
deep within the Apple II according to 
John Conway and Jack Hemenway of EDN 
magazine. As part of their system de- 
sign project based on a bare-board 
Apple - "Project Indecomp" - they tried 
to interface a 6820 PIA to the Apple, 
and uncovered a potentially serious 
problem. The normal way to operate a 
6502 based system is to provide an ex- 
ternal clock [phase 0] to the 6502 
which then generates two non-overlap- 
ping clock signal [phase 1 and phase 2] 
which are used to control all system 
timing. For some reason, the design of 
the Apple II violated this basic clock 
scheme and uses the phase external 
clock instead of the 6502 generated 
phase 2 clock. While these two clocks 



are very similar, they are not identi- 
cal . Phase 1 and phase have an over- 
lap of about 50 nanoseconds. For many 
parts of the system this is not import- 
ant, as indicated by the fact that the 
Apple II works. For other devices, 
however, such as the 6820 PIA, this 
difference is critical to the extent 
that the device simply will not work. 
A report in EDN scheduled for 20 May 
will cover this problem in detail, and 
we will try to get more info for the 
next issue of MICRO. Is the problem 
serious? Critical? Fatal? It is 
probably too early to judge the effect 
of this problem. It may not have an 
adverse effect in many systems. It may 
be possible to correct. Or it may be a 
very serious system problem. 



HALF A MORN W THE APPLE 

Mike Rowe 

P.O. Box 3 

S. Chelmsford, MA 01824 



Last issue we reported a potential 
problem that had been discovered in the 
Apple II, relating to using PIA' a. The 
problem had been uncovered by the staff 
of EDN in the course of developing a 
system based on an Apple II board. The 
matter is not totally resolved, but the 
following is what we have heard. 

I called Steve Wozniak of Apple and 
asked about the problem. He said that 
he had sent a chip to EDN which had 
cleared up the problem. He did not in- 
dicate that there was any more to it. 

I then talked to John Conway of EDN. 
He maintained that a problem still does 
exist with Apple II interfacing to 6520 
or 6522 PIAs. It can be done, but re- 
quires the addition of a chip to slow 
down the phase signal to make it the 
equivalent of the phase 2 signal. The 



PIA can not be directly interfaced, as 
would normally be expected in a 6502- 
based system. John stated that the 
chip required costs about $7.00. 

Another angle on the picture was also 
reported to me by John. He had found a 
company on the West Coast that is mak- 
ing interfaces for the Apple II. The 
engineer there had discovered the same 
problem. 

There is a fairly complete discussion 
of the problem and the solution in the 
May 20, 1978 edition of EDN. If anyone 
has additional information to shed on 
the situation, MICRO will be happy to 
publish it. The problem does not seem 
to be all that serious, and we do not 
want to dwell on it, but we hope that 
this discussion has prevented some of 
our readers from going nuts trying to 
add a PIA to their Apple II. 
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APPLE PI 



Robert 3. Bishop 

1143 W. Badillo, Apt E 

Covina, CA 91722 



Everyone knows that the value of Pi is about 
■3.1416. In fact, its value was known this accu- 
rately as far back as 150 A.D. But it wasn't 
until the sixteenth century that Francisco Vieta 
succeeded in calculating Pi to ten decimal 
places. 

Around the end of the sixteenth century the 
German mathematician, Ludolph von Ceulen, worked 
on calculating the value of Pi until he died at 
the age of 70. His efforts produced Pi to 35 
decimal places . 

During the next several centuries a great deal 
of effort was spent in computing the value of PI 
to evern greater precision. In 1699 Abraham 
Sharp calculated Pi to 71 decimal places. By 
the mid 1800's its value was known to several 
hundred decimal places. Finally, in 1873 » an 
English mathematician, Shanks, determined Pi to 
707 decimal places, an accuracy which remained 
unchallenged for many years. 

I was recently rereading my old copy of Kasner & 
Newman" s Mathematics and the Imagination 

I was recently rereading my old copy of Kasner & 
Newman's Mathematics and Imagination (Simon & 
Schuster, 1940), where I found the series expan- 
sion: 



TV 



K=l K=l 



4H) 



k+i 



(Zk-I)23<?' 



The book indicated that this series converged 
rather quickly but "... it would require ten 
years of calculation to determine Pi to 1000 
decimal places." Clearly this statement was 
made before modern digital computers were avail- 
able. Since then, Pi has been computed to many 
thousands of decimal places. But Kasner & 
Newman's conjecture of a ten-year calculation 
for Pi aroused my curiousity to see just how 
long it would take my little Apple-II computer 
to perform the task. 

Program Description 

My program to compute the value of Pi is shown 
in Figure 1 . It was written using the Apple II 
computer's Integer BASIC and requires a 16K 
system (2K for the program inself ; 12K for data 
storage) . The program is fairly straightforward 
but a brief discussion may be helpful. 

The main calculation loop consists of lines 100 
through 300; the results are printed in lines 
400 through 600. The second half of the listing 
contains the multiple precision arithmetic sub- 
routines. The division, addition, and subtrac- 
tion routines start at lines 1000, 2000, and 
3000, respectively. 

In order to use memory more efficiently, PEEK 
and POKE statements were used for arrays, instead 
of DIM statements. Three such arrays are used 
by the program: POWER, TERM, and RESULT. Each 
are up to 4K bytes long and start at the memory 
locations specified in line 50 of the program. 



The three arrays mentioned above each store par- 
tial and intermediate results of the calcula- 
tions. Each byte of an array contains either 
one or two digits, depending on the value of the 
variable, TEN. If the number of requested 
digits for Pi is less than about 200, it is 
possible to store two digits per byte; other- 
wise , each byte must contain no more than one 
digit. (The reason for this distinction occurs 
in line 1070 where an arithmetic overflow can 
occur when trying to evaluate higher order terms 
of the series if too many digits are packed into 
each byte . ) 

The program evaluates the series expansion for 
Pi until the next term of the series results in 
a value less than the requested precision. Line 
1055 computes the variable, ZERO, which can be 
tested to see if an underflow in precision has 
occurred. This value is then passed back to the 
main program where , in line 270 , it determines 
whether or not the next term of the series is 
needed . 

Results 

Figure 2 shows the calculated value of Pi to 
1000 decimal places. Running the program to get 
these results took longer than it did to write 
the program! (The program ran for almost 40 
hours before it spit out the answer.) However 
it took less than two minutes to produce Pi to 
35 decimal places, the same accuracy to which 
Ludolph von Ceulen spent his whole life striving 
for! 

Since the program is written entirely in BASIC 
it is understandably slow. By rewriting all or 
part of it in machine language its performance 
could be vastly improved. However, I will leave 
this implementation as an exercise for anyone 
who is interested in pursuing it. 

Note: You must set HIMEM:4096. 
Figure 1 . 
Program Listing 

>LIST 

8 REH *** flPPLE-PI *** 
WRITTEN BV: BOB BISHOP 
5 CALL -936: VTflB 18: THB 5: PRINT 
"HUM MflNV DIGITS DO YOU HRNT" 

18 INPUT SIZE 

15 CALL -936 

28 TEN=18: IF SIZE>289 THEN 58 

38 TEH=188:SIZE=<SIZE+l)/2 

99 PQf£R=40%: TERH=8192: RESULT* 

12288 
68 DIV=1000:flDD=288e:SUB=3880: 

INIT=4088.COPV'=5880 
78 DM CONSTANTS): CGNSTfiNTd) 

=25: C0NSTflNT<2>=239 



85 



125 
156 
286 
218 

228 
236 
240 
256 



586 
516 



578 



1696 
1818 



1836 
1846 
1858 
1855 



res mm loop 

FOR PfiSS=l TO 2 

GOSUB INST 

GOSUB COPV 

POIKT-TEWI: DIVI&£=EXP: GOSUB 

DIV 

IF SIGfOQ THEN GOSUB ADD 

IF SIGNC8 THEN GOSUB SUB 

EXP=EXP+2:SIGN=-SIGN 

POINT ^POiCR : DIV1 DE=CONSTfiNT< 

PASS): 60SUB 01 V 

IF PflSS=2 THEN GOSUE: DIV 

IF ZER0O8 THEN 28(3 

NEXT PASS 

REH PRINT THE RESULT 

PRINT : PRINT 

PRINT "THE VALUE OF PI TO " 

; <TEN/i60+i>*SI2E.; " DECIMAL. PLAC 

ES: H : PRINT 

PRINT PEEK (.RESULT);". "; 

POR PLflCE=RESULT+l TO RESULT* 

SIZE 

IF 7EN=18 THEN 578 

IF PEEK (PLACEX18 THEN PRINT 

"8"; 

PRINT PEEK <PLflCE); 

NEXT PLACE 

PRINT 

END 

REH DIVISION SUBROUTINE 

DIGITS: 2ERO=8 

FOR PLACE=PQINT TO P0INT+S1ZE 

DI6IT=DIGIT+ PEEK (PLACE) 

QU0T1ENT=DIGIT,<'D1VIDE 

RES1DUE=DIGIT MOD DIVIDE 

ZERG=ZERO OR (8U0TIENT+RES1DUE) 



1866 POKE PLACE, QUOTIENT 

1876 DI6IT=TBW?E5IMJE 

1886 NEXT PLACE 

1090 RETURN 

2886 REH ADDITION SUBROUTINE 

28i6 CARRV=0 

2828 FOR PLflCE=SIZE TO 8 STEP -1 



SUfi= PEEK (RESULT+PLACE)* PEEK 

(.'TERH+PLflCEHCARRV 

CflRRV~0 

IF SUKTEN THEN 2888 

SUH=SUPI-TEN 

CARRV = 1 

POKE RESULT+FlfiCBSUH 

NEXT PLACE 

RETURN 

RES SUBTRACTION SUBROUTINE 

LQf»M3 

FOR PLACE=SIZE TO 8 STEP -1 



2846 



2868 
28?6 



3826 



'Even "Apple Pi" isn't simple any more! Neil D. 
Lipson oT the Philadelphia Apple Users Group 
writes that "The Pi article by Bob Bishop (MICRO 
6:15) is missing one thing. Add HIMEM:4096." 
But, that's not" all! John Paladini writes that: 
"The value of Pi was not computed to 1000 deci- 
mal places, but rather 998. Such inaccuracies 
occur when computing a series where billions of 
calculations are required. My best guess is that 
in order to calculate Pi to 1,000 places using 
the given series one would have to compute to 
1,004 places. The last two digits should read 

,89 not 96." 



3838 DIFFERENCE^ PEEK CRESULT+PLACE) 

- PEEK <TERmPLflCE)-LOFW 
3848 L0flK=8 

3858 IF DIFFERENCES THEN 3888 
3868 DIFFERENCES! FFERtNCE+TEN 
3878 L0flM=l 

3888 POKE RESULT+PLfiCE, DIFFERENCE 
3898 NEXT PLACE 
3186 RETURN 

4896 RE?) INITIALIZE REGISTERS 
4810 FOR PLACED TO SIZE 
4828 POKE PQHER+FLflCE, 8 

POKE TERil+PLACE, S 

IF PflSS=l THEN POKE RESULT* 

PLfiCE, 8 

NEXT PLACE 

POKE POWER, 16/PASS t 2 
4878 IF PASS=1 THEN D1VIDE=5 
4888 IF PfiSS=2 THEN D1VIDE=239 
4898 P0INT=P0i€R: GOSUB DIV 
4188 EXP=1:SI6N=:3-2*PASS 
4116 RETURN 

5886 REH COPV "POWER" INTO "TERM" 
5816 FOR PLflCE=8 TO SIZE 
5828 POKE TERH+PL.ACE, PEEK (P0ICR+ 

PLACE:? 
5638 NEXT PLACE 
5846 RETURN 



THE VALUE OF PI TO 1600 DECIMAL PLACES: 



i327956288419 



3. 14159265358979323846264338: 

7169399375105826974944592367816486286208 
9986280348253421170679821480865132823866 
4709384468955058223172535540812848111745 
028418270193852118555964462294895493038! 
9644288189756659334461284756482337867831 
6527120196914564856692346834861845432664 
8213393687260249141273724587006606315588 
1748815289209628292548917153643678925903 
6081133053854882846652138414695194151160 

9433857278365759591953892186117381932611 
7931651185480744623799627495673518857527 
2489122793818361194912983367336244065664 
3086821394946395224737198782179868943782 
7785392171762931767523846748184676694051 
328885S81271452635&082778577134275778968 
9173637178721468440991224953430146549585 
3716507922796892589235428199561121290219 
6086403441815981362977477138996051870721 
1349999998372978849951859731732816096318 
59582445945534690830264:25223082533446858 
3526193118817181888313783875288658753326 
8381426617177669147383598253498428755468 
7311595628638823537875937519577818577805 
3217122688661308192787661119598921642019 
96 



Figure 2. 
Pi to 1000 Decimal Places 
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THE APPLE II POWER SUPPLY 
REVISITED 

Rod Holt 

Chief Engineer 

Apple Computer Inc. 

20863 Stevens Creek Blvd., B3-C 

Cupertino, CA 95014 



Your review of the Apple II ("Inside 
the Apple II" by Arthur Ferruzzi ,BEST of 
MICRO, p. 83; was most gratifying. How- 
ever, your comment about the "small" 
power supply invites a reply. 

The power supply has no function other 
than running the Apple II and its pe- 
ripherals, and as it does this very 
well, then what's "small"? Apple Com- 
puter is far enough along in peripheral 
card development to state categorically 
that with an EPROM card, a ROM card, a 
parallel printer card, a floppy disk 
card, and several more all plugged in, 
the power supply isn't even breathing 
hard. 

We do recommend that users keep their 
designs to a reasonable minimum power. 
But the reason for this is the same as 
one of the reasons Apple designed a 
switching regulator in the first place: 
to keep temperature rises to a minimum. 
The general rule of thumb is that a 25 
degree C increase in ambient will drop 
the mean time between failures by a 
factor of 10. For the user, the watts 
saved mean literally thousands of hours 
more of trouble free system operation. 
The switcher design cuts the input pow- 
er nearly in half over conventional 
regulators and the overall temperature 
rise is reduced by approximately 25 C. 



And, of course, the use of low-power 
schottky and a tight and economic hard- 
ware design is key as well. 



A second point needs to be made. It's 
quite common to have well over a thous- 
and dollars in semiconducters in an 
Apple II system. The Apple switcher is 
designed to protect those semiconduct- 
ers under all fault conditions (includ- 
ing possible failure modes internal to 
the power supply itself) . Never has an 
Apple II been damaged by its own power 
supply. In contrast, Apple can docu- 
ment many cases of blown RAM and other 
IC ' s where customers have used homemade 
or "off the shelf" power supplies. See 
the sad story in EDN, November 20, 1977 
page 232. There are many more such sad 
stories. The power supply manufactur- 
ers of the world are just beginning to 
see that a supply failure means much 
more than just an equipment shut-down 
nuisance. Thus it's important to know 
what happens when, for example, the +12 
volt supply is shorted to the -5 volt 
supply. What happens to the +5 volts? 
With the Apple switcher, all supplies 
neatly go to zero, and they all recover 
smoothly when the short is removed. 

I close by murmuring - 

"Small is Beautiful". 
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PRINTING WITH THE APPLE II 



C. R. (Chuck) Carpenter W5USJ 
2228 Montclair Place 
' Carrollton, TX 75006 



Hardcopy output from your Apple II is a 
practical reality. All you need is a 
TELPAR thermal printer, a simple one- 
transistor adapter circuit and a 
machine language printing routine. The 
printing routine slows the data rate 
down to 110 (or 300) baud and directs 
the data stream to AN0 (the game pad- 
dle connector - annunciator output, 
port zero). I have the TELPAR PS-40-3C 
(now PS-48) connected to my Apple II 
and I am printing everything from Bio- 
rhythms to Manpower Planning programs. 
Here are the details for hooking up the 
printer. 



The TELPAR PS-40-3C 

The PS-40 (Photo 1) is a 48 column 
thermal printer using 5.5 inch width 
paper. The model I have is a 3 chip F8 
controlled unit. The current, more 
compact models use a single chip 
F8/3870. Inputs are provided for 
serial TTL, RS 232 and 20 MA current 
loop. You can also connect a parallel 
port to the printer and software con- 
trollable options are available. The 
printer can be used as the only I/O if 
a keyboard is connected as the parallel 
source. The paper is not too expensive 
at $3.00 per 164 foot roll. 

Power supply voltages are critical and 
several are required. (This is the 
only shortcoming I found with this gen- 
eral purpose printer.) Good regulation 
is a must from your power supply. Es- 
pecially the printhead supply voltage 
(16). Excessive positive deviations 
here can blow the printhead. Telpar 
can supply a switching type power sup- 
ply that will do the job. The connec- 
tions to the 56 pin edge connector are 
shown in Figure 1 . The connector act- 
ually has numbers and letters to des- 
ignate pins. Somewhere along the line, 
numbers were assigned to both sides. 
Be sure you transpose the numbers cor- 
rectly and connect it to the circuit 
board properly. Telpar has good repair 
service, but it still takes time. 



Interface Adapter 

All that is needed to connect the Apple 
II to an RS 232 printer input is the 
adapter circuit shown in Figure 2 (from 
an Apple application note). I built 
this circuit on a 16 pin IC header and 
plugged it in. There is some inconven- 
ience if you want to use the game pad- 
dles too, but I think there is a way 
around this if you choose to do some 
rewiring. 

You can get the -12 volts for this cir- 
cuit from the main power connector. A 
short lead and a small connector pin 
will work. If the pin is small enough, 
it will slide down inside the -12 volt 
terminal on the power connector. There 
are other places like the keyboard 
where -12 volts is also available. Use 
caution making this connection. 



Making it Print 

Now the only part left is a way to get 
the data slowed down and directed to 
the AN0 output port. Apple has taken 
care of this detail with the routine 
shown in Figure 3. You can key in this 
routine and save it on tape. Each time 
you have a printing task the program is 
easily loaded using Apple's system mon- 
itor commands. I've used it with mach- 
ine language programs and both forms of 
BASIC: Apple's Integer BASIC and 
Applesoft Floating Point 8K BASIC. The 
routine is called as follows: 

$380G and RETURN in machine language 

CALL 896 in Apple Integer BASIC 

X=USR(896) in Applesoft 8K BASIC 

Note: A line number is not needed to 
call the print routine. (380 hex = 896 
decimal) . 

Using RESET will stop the print routine 
in machine language and in Apple Inte- 
ger BASIC (return to BASIC with the 
soft entry CONTROL-C). With Applesoft 
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in RAM, exiting via RESET and re-entry 
the soft way with OG works sometimes 
but usually causes a glitch in BASIC 
and messes up the program. I avoid 
this problem by waiting to do any 
printing until the last thing. Any 
further changes are made at the slower 
speed. I would speculate that things 
like this will clear up when Applesoft 
is in ROM. I'm still looking for a way 
to get out of the print routine direct- 
ly from the BASIC program. 

The Tale is Told 

As I indicated at the beginning, I'm 
printing most anything I want to. The 
5.5 inch paper width presents some lim- 
itations but most programs can be for- 
matted to work okay. There are several 
features and details I've alluded to 
but an article to do them justice would 
take several issues of MICRO to cover. 



Telpar has a technical paper that des- 
cribes them and would be happy to send 
you one. For a simple, effective, gen- 
eral purpose printer, I have not found 
a better choice than my Telpar thermal. 
I think you would find it a good choice 
too. 

For more info, write to: 

Telpar Inc. 

4132 Billy Mitchell Road 

P.O. Box 796 

Addison, TX 75001 

[Editor's Note: One problem I have 
found with this thermal printer is that 
the print is light blue. This can 
cause great difficulty if you want to 
copy the output since most xerox-type 
copiers and many plate-making films are 
"blind" to light blue.] 




Photo 1 (by Jim Chamberlain) 
APPLE II and TELPAR Thermal Printer 
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Figure 1 

PS-40 Connector Diagram: 
Input and Power Connections 
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Figure 2 

Single Transistor Adapter Circuit 
and Interface 



0390- C9 3B B0 QC P9 8R £0 h5 

03R0- R4 35 4C F"0 FB R0 6E 18 
83R8- 48 B0 05 RB 56 00 90 03 
83B0- RB 59 C0 R9 B3 48 H9 £0 
03BS- 4fl .90 FD 68 £9 01 DP F"5 
03C0- 68 6fl 88 B0 £3 60 00 00 



Apple II ANO output routine in machine 
language to provide serial data output 
at 110 and 300 baud. Change location 
$3B4 to $4D for 300 baud. 



[Note: This listing and dump were made 
on the Telpar printer.] 



Figure 3 

Machine Language Print Routine 
and HEX Dump 
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APPLE II PRINTING UPDATE 

C. R. (Chuck) Carpenter W5USJ 
2228 Montclair Place 
Carrollton, TX 75006 



"Printing with the Apple II" [Page #881 
included information that has been re- 
vised. Since the article was written, 
I've improved some things and I'd like 
to pass them along. 

The Adapter Didn't 

After using the adapter circuit for a 
couple of months, I took a good look at 
what was happening. The conclusion was 
nothing! Initially, it didn't work 
when I connected it to the RS-232 re- 
ceiver on the PS-40. I connected it to 
the serial TTL input (pin A7) and it 
worked. The voltage swing wasn't ex- 
cessive (clamped with some diodes) , so 
I left it hooked-up. Should have been 
a clue. But at the time I didn't see 
it, and anyway, it worked. 

During one of our (infrequent) snowed- 
in days here in Texas, I had time to 
think about it. There wasn't any ap- 
parent reason not to hook it up direct- 
ly; and I did. It worked the way it 
should so I had a no- interface-required 
computer to printer system. When I re- 
ceived my new Apple Operator's Manual I 
noticed a new interface circuit, not 
the one I used as originally provided. 

All that is needed is to connect a sig- 
nal lead and ground from the Apple to 
the printer. The signal lead connects 
to Pin 15 of Apple's game paddle con- 
nector. Also to Pin A7, TTL serial 
data in, on the printer. I soldered 
the game paddle connector to the 16 pin 
header. No other connections needed. 



The Blues Are Gone 

Most of my programs are printed on the 
paper that turns blue (and fades). 
Telpar has a black on off-white paper 
now. This new paper makes a much 
sharper copy too. The blue paper was 
also susceptible to smearing. This did 
not help the copy quality either, 
photographically or Xerographically. 

There! Now that the problems are re- 
solved, what's holding you back? Let's 
get printing. 

Author's Note: Even if you don't have 
a printer, the print routine is useful. 
Use it to slow the screen speed down. 
This way you can read a listing during 
a slow scroll. 



Getting Decimal Values 
From Hex Data 

For some other program, POKE was used 
to enter machine language from BASIC. 
I did this for the print routine. All 
the HEX values have to be converted to 
decimal. At first I did this with the 
TI Programmer. Then I "discovered" 
what PEEK is all about. A BASIC pro- 
gram to print the decimal values simp- 
lifies the job. Convert the first and 
last addresses (to do a range of ad- 
dresses) to their decimal values 
These values are 875 and 967 for the 
print program. Then use them in a FOR- 
NEXT routine like this: 



Now You Can Start and Stop 

Ted Spradley, a programmer/engineer at 
work, helped me with the machine lang- 
uage print program. His analysis sug- 
gested restoring the page zero regis- 
ters to make the print routine stop. 
As you more experienced programmers 
would know, it worked. I, rewrote the 
program to store and restore the page 
zero data and now the routine turns on 
and off under program control. The 
program , shown in Figure 1 , was a re- 
velation to me. Again, my thanks to 
Ted for his assistance. 



100 FOR 1=875 TO 967:PRINT PEEK(I); 
PRINT" "; :NEXT I: END 



This reduced a two hour job to about 
ten minutes. Hooray for progress. 
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Listing 



HEX Dump 



H-36BLLL 



H-yfei; . :ji 



0- 

83 

03 

83 

63 

03 

03 

83 

03 

03 

83 

03 

03 

03 

83 

83 

83 

83 

83 

83 

£< 

K 

8:! 

8:; 

8:! 

& 

83 

0:! 

&■. 

K 

£< 

£< 

8-"! 

8:; 

K 

8; 

0:i 

83 

8:! 

£< 

E< 

8; 

83 

83 

8: 

8 

83 

8:' 



5B- 
§D- 



fB~ 
7B- 
7E- 
81- 



8F- 

98- 
92 _ 

94- 
96- 
99— 
9B- 
9E- 
R8- 
R£- 
R5- 
R7- 
R8- 
R9- 
RE- 
RE- 
B8- 
B3- 
B5- 
B6- 
E8- 
B9- 
BB- 
BC- 
BE- 
C8 - 
Cl- 



C5- 
C6- 



H5 36 
SB C6 03 
R5 37 
SB C7 83 
Fl9 89 

fl9 83 



fc,0 
RB C 

RB ( 



6 03 
i Li." 



68 

84 35 

48 

£8 fli 83 

68 

C9 8D 

B8 8C 

R9 8fi 

£8 R5 83 

R9 58 

£8 R8 FC 

R9 SB 

R4 35 

4C F8 FB 

R8 8B 

18 

48 

B8 85 

RB 58 C8 

98 83 

RB 59 C8 

R9 B3 

48 

R9 £8 

4R 

98 FB 

68 

E9 01 

B0 F5 

68 

6fl 

l~H™l 

'— "— ' 

B8 E3 
68 
F8 FB 



LBR 
SIR 
LBR 
STfi 
LBR 
STfi 
LBR 
STR 
RTS 
LBR 
STR 
LBR 
STR 
RTS 
STY 
PHR 
JSR 
F'LR 
CMP 
BNE 
LBR 
JSR 
LBR 
JSR 
LBR 
LBV 
JMP 
LBV 
CLC 
PHR 
BCS 
LBR 
BCC 
LBR 
LBR 
PHR 
LBR 
LSR 
BCC 
PLR 
SBC 
BNE 
PLR 
ROR 
DEY 
BNE 
RTS 
BEQ 



$36 

$831": 6 

$37 

$83C7 

#$89 

$36 

#$83 

$37 

$83C6 
$36 
$83C7 
$37 

$35 

$83R5 

#$8B 

$83R8 

#$8fl 

$03R5 

#$58 

$FCR8 

#$8B 

$35 

$FBF8 

#$8B 



$03B0 
$C058 
$83E3 
$C059 
#$B3 

#$£0 

$03E8 

#$£U 
$03E5 



$83R8 
$83C5 



836B- 


rjc:; 


36 


b'B 


8378- 


R5 


O l 


('" Ti 
OX! 


0378- 


36 


h'-J 


83 


0380 - 


03 


!-;Fi 


36 


8388- 


60 


84 


■™: ET 


8398 - 


C9 


Oil 


B8 


8398- 


83 


(™i <~{ 


C-"0 


03R8- 


R4 


"ic; 


4C 


03R8- 


•H-H 


B8 


85 


03B0- 


RB 


59 


C8 


03B8- 


4fi 


98 


FB 


03C0- 


68 


6 hi 


O O 


+ 









C6 


03' 








C7 


83 


R9 


89 




p £'■'. 


■■"i~ 


60 


fill 


C6 


RB 


C7 


03 


qc: 


■"": "T 1 


48 


£8 


R5 


83 


68 


8C 


1=19 


8R 


£0 


R5 


£8 


R8 


FC 


R9 


SB 


F8 


FB 


R8 


8B 


18 


RB 


cro 


C0 


98 


83 


R9 


B3 


48 


R9 


£8 



68 E9.81 B8 F5 
B8 E3 68 FS FB 



Print Routine 
START Print STOP Print 



»36BG 
>CALL 875 
]SP=USR(875) 



*37EG 
>CALL 894 
]EP=USR(894) 



Type in one of above and then type 
RETURN to activate the command. 

* = from Apple Monitor 
> = from Integer BASIC 
] = from Applesoft BASIC 

Change 03B4 to 4D for 300 baud. 



Figure 1 
Listing and HEX Dump of Machine Language Print Routine 
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A SLUM LIST FOR APPLE BASIC 

Bob Sander-Cederlof 

8413 Midpark Road No. 3072 

Dallas, TX 75240 



One of the nicest things about Apple 
BASIC is its speed. It runs circles a- 
round most other hobby systems! Yet 
there are times when I honestly wish it 
were a little slower. 

Have you ever typed in a huge program, 
and then wanted to review it for er- 
rors? You type "LIST", and the whole 
thing flashes past your eyes in a few 
seconds! That's no good, so you list 
it piecemeal — painfully typing in a 
long series like: 

LIST 0,99 
LIST 100,250 



But there is a better way! I wrote a 
small machine language program which 
solves our problem. After this little 
64-byte routine is loaded and activated 
the LIST command has all the features 
we wanted. 

1 . The listing proceeds at a more lei- 
surely pace, allowing you to see what 
is going by. 

2. The listing can be stopped tempor- 
arily, by merely pressing the space 
bar. When you are ready, pressing the 
space bar a second time will cause the 
listing to resume. 

3. The listing can be aborted before 
it is finished, by typing a carriage 
return. 



LIST 21250,21399 

As the reviewing and editing process 
continues, you have to type these over 
and over and over . . . Ouch! 

At the March meeting of the Dallas area 
"Apple Corps" several members expressed 
the desire to be able to list long pro- 
grams slowly enough to read, without 
the extra effort of typing separate 
commands for each screen-full. One 
member suggested appending the series 
of LIST commands to the program itself, 
with a subroutine to wait for a car- 
riage return before proceeding from one 
screen- full to the next. For example: 

9000 LIST 0,99:G0SUB 9500 
9010 LIST 100,250: GOSUB 9500 



9250 LIST 2 1250, 2 1399: GOSUB 9500 

9260 END 

9500 INPUT A$: RETURN 

While this method will indeed work, it 
is time-consuming to figure out what 
line ranges to use in each LIST com- 
mand. It is also necessary to keep 
them up-to-date after adding new lines 
or deleting old ones. 



The routine as it is now coded resides 
in page three of memory, from $03**0 to 
$037F. It is loaded from cassette tape 
in the usual way: *3 1 »0.37FR. 

After the routine is loaded, you return 
to BASIC. The slow-list features are 
activated by typing "CALL 887". They 
may be de-activated by typing "CALL 
878" or by hitting the RESET key. 

How does it work? The commented assem- 
bly listing should be self-explanatory, 
with the exception of the tie-in to the 
Apple firmware. All character output 
in the Apple funnels through the same 
subroutine: C0UT, at location $FDED. 
The instruction at $FDED is JMP ($0036) 
This means that the -idrcss which is 
stored in locations $0036 and $0037 in- 
dicates where the character output sub- 
routine really is. Every time you hit 
the RESET key, the firmware monitor 
sets up those two locations to point to 
$FDF0, which is where the rest of the 
C0UT subroutine is located. If char- 
acters are supposed to go to some other 
peripheral device , you would patch in 
the address of your device handler at 
these same two locations. In the case 
of the slow-list program, the activa- 
tion routine merely patches locations 
$0036 and $0037 to point to $0340. The 
de-activation routine makes them point 
to $FDF0 again. 
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Every time slow-list detects a carriage 
return being output, it calls a delay 
subroutine in the firmware at $FCA8. 
This has the effect of slowing down the 
listing. Slow-list also keeps looking 
at the keyboard strobe, to see if you 
have typed a space or a carriage re- 
turn. If you have typed a carriage re- 
turn, slow-list stops the listing and 
jumps back into BASIC at the soft entry 



point ($E003). If you have typed a 
space, slow-list goes into a loop wait- 
ing for you to type another character 
before resuming the listing. 

That is all there is to it! Now go 
turn on your Apple, type in the slow- 
list program, and list to your heart's 
content! 



CR40 



ORG $0340 



ROUTINE TO SLOW DOWN APPLE BASIC LISTINGS 



0340 C9 8D SLOW CMPIM 
0342 DO 1A BNE 

0344 48 PHA 

0345 2C 00 CO BIT 
0348 10 0E BPL 
034A AD 00 CO LDA 
034D 2C 10 CO BIT 
0350 C9 A0 CMPIM 
0352 F0 10 BEQ 
0354 C9 8D CMPIM 
0356 F0 09 BEQ 
0358 A9 00 WAIT LDAIM 
035A 20 A8 FC JSR 
035D 68 PLA 
035E 4C F0 FD CHROUT JMP 
0361 4C 03 E0 ABORT JMP 
0364 2C 00 CO STOP BIT 
0367 10 FB BPL 
0369 8D 10 CO STA 
036C 30 EA BMI 



$8D CHECK IF CHAR IS CARRIAGE RETURN 

CHROUT NO, SO GO BACK TO COUT 

SAVE CHARACTER ON STACK 

$C000 TEST KEYBOARD STROBE 

WAIT NOTHING TYPED YET 

$C000 GET CHARACTER FROM KEYBOARD 

$C010 CLEAR KEYBOARD STROBE 

$A0 CHECK IF CHAR IS A SPACE 

STOP YES - STOP LISTING 

$8D CHECK IF CHAR IS A CARRIAGE RETURN 

ABORT YES - ABORT LISTING 

$00 MAKE A LONG DELAY 

$FCA8 CALL MONITOR DELAY SUBROUTINE 

GET CHARACTER FROM STACK 

$FDF0 REJOIN COUT SUBROUTINE 

$E003 SOFT ENTRY INTO APPLE BASIC 

$C000 WAIT UNTIL KEYBOARD STROBE 

STOP APPEARS ON THE SCENE 

$C010 CLEAR THE STROBE 

WAIT UNCONDITIONAL BRANCH 



SUBROUTINE TO DE-ACTIVATE SLOW LIST 



036E A9 FO 
0370 85 36 
0372 A9 FD 
0374 85 37 
0376 60 



OFF 



LDAIM $F0 
STAZ $36 
LDAIM $FD 
STAZ 
RTS 



$37 



RESTORE $FDF0 TO 
LOCATIONS 36 AND 37 



SUBROUTINE TO ACTIVATE SLOW LIST 





0377 


A9 40 


ON 


LDAIM 


$40 


SET $0340 INTO 




0379 


85 36 




STAZ 


$36 


LOCATIONS 36 AND 37 




037B 


A9 03 




LDAIM 


$03 






037D 85 37 




STAZ 


$37 






037F 


60 




RTS 






SYMBOL 


TABLE 












ABORT 


0361 


CHROUT 


035E 


OFF 


036E 


ON 0377 


SLOW 


0340 


STOP 


0364 


WAIT 


0358 




SYMBOL 


TABLE 












SLOW 


0340 


WAIT 


0358 


CHROUT 


035E 


ABORT 0361 


STOP 


0364 


OFF 


036E 


ON 


0377 
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AN APPLE-II PROGRAMMER'S GUIDE 

(You Can Get There From Here!) 

Rick Auricchio 

59 Plymouth Avenue 

Maplewood, N3 07040 



Most of the power of the APPLE-II comes 
in a "secret" form - almost undocument- 
ed software. After several months of 
coding, experimenting, digging, and 
writing to APPLE, most of the APPLE'S 
pertinent software details have come to 
light . 

Although most of the ROM software has 
been printed in the APPLE Reference 
Manual , its Integer Basic has not been 
listed; as a result, this article will 
be limited to Monitor software. Per- 
haps when a source listing of Integer 
Basic becomes available, we'll be able 
to interface with some of its many rou- 
tines. 

First Things First 

When I took delivery of my Apple (July 
1977), all I had was a "preliminary" 
manual - no goodies like listings or 
programming examples. My first letter 
to Apple brought a listing of the Moni- 
tor. Seeing what appeared to be a big 
jumble of instructions, I set out div- 
iding the listing into logical routines 
while deciphering their input and out- 
put parameters. Once this was done, I 
could look at portions of the code 
without becoming dizzy. 

The Monitor's code suffers from a few 
ills: 

1 Subroutines lack a descriptive "pre- 
amble" stating function, calling seq- 
quences, and interface details. 

2 Many subroutines have several entry 
points, each of which does something 
slightly different. 

3 Useful routines are not documented 
in a concise form for user access. 

I will concede that, while using a 
"shoehorn" to squeeze as much function 
as possible into those tiny ROM's, some 
shortcuts are to be expected. However, 
those valuable Comment Cards don't use 
up any memory space in the finished 
product - 'nuff said. 



The Good Stuff 

The best way to present the Apple's 
software interface details is to des- 
cribe them in tabular form, with fur- 
ther explanation about the more complex 
ones. The following tables will be 
found on the back cover of this issue: 

Table 1 outlines the important data 
areas used by the Monitor. These 
fields are used both internally by the 
Monitor , and in user communication with 
many Monitor routines. Not all of the 
data fields are listed in Table 1 . 

Table 2 gives a quick description of 
most of the useful Monitor routines: 
it contains Name, Location, Function, 
Input/Output parameters, and Volatile 
(clobbered) Registers. 

Don't hesitate to experiment with these 
routines - since all the important 
software is in ROM, you can't clobber 
anything by trying them out (except 
what you might have in RAM, so beware) . 

Using the "User Exits" 

The Monitor provides a few nice User 
Exits for us to get our hands into the 
Monitor. With these, it is a simple 
matter to "hook in" special I/O and 
command-processing routines to extend 
the Apple's capabilities. 

Two of the most useful exits are the 
KEYIN and COUT exits. These routines, 
central to the function of the Monitor, 
are called to read the keyboard and 
output characters to the screen. By 
placing the address of a user routine 
in CSWH/L or KSWH/L, we will get con- 
trol from the Monitor whenever it at- 
tempts to read the keys or output to 
the screen . 

As an example of this exit's action, 
try this: with no I/O board in I/O 
Slot 5, key-in "Kc5" (5, followed by 
control K, then Return). You'll have 
to hit Reset to stop the system. 
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II APPLE II PROGRAMME! 'S GUIDE 

Rick Auricchio 

59 Plymouth Avenue 

Maplewood, NJ 07040 



MONITOR Data Areas in Page Zero 



Name 



Loc 



Function 



WNDLEFT 

WNDWDTH 

WNDTOP 

WNDBTM 

CH 

CV 

COLOR 

INVFLG 

PROMPT 

CSWL 

CSWH 

KSWL 

KSWH 

PCL 

PCH 

A1L 

A1H 

A2L 

A2H 

A3L 

A3H 

A4L 

A4H 

A5L 

A5H 

ACC 

XREG 

YREG 

STATUS 

SPNT 



20 
21 
22 
23 
24 
25 
30 
32 

33 
36 
37 
38 
39 
3A 
3B 
3C 
3D 
3E 
3F 
40 
41 
42 
43 
44 
45 
45 
46 
47 
48 
49 



Scrolling window: left side (0-$27) 
Scrolling window: width ( 1 -$28 ) 
Scrolling window: top line (0~$16) 
Scrolling window: bottom line (1-$17) 
Cursor: horizontal position (0-$27) 
Cursor: vertical position ( 0-$ 17) 
Current COLOR for PL0T/HLIN/VLIN functions 
Video Format Control Mask: 
$FF=Normal, $7F=Blinking , $3F=Inverse 
Prompt character: printed on GETLN CALL 
Low PC for user exit on COUT routine 
High PC for user exit on COUT routine 
Low PC for user exit on KEYIN routine 
High PC for user exit on KEYIN routine 
Low User PC saved here on BRK to Monitor 
High User PC saved here on BRK to Monitor 
A1 to A5 are pairs of Monitor work bytes 



User AC saved here on BRK to Monitor 

User X saved here on BRK to Monitor 

User Y saved here on BRK to Monitor 

User P status saved here on BRK to Monitor 

User Stack Pointer saved here on BRK 



Page 2 ($0200-$02FF) is used as the KEY.IN Buffer. 

Pages 4-7 ( $0400-$07FF) are used as the Screen Buffer 
Page 8 ($0800-$08FF) is the "secondary" Screen Buffer 



Table 1, 



N. 
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Name 



PLOT 



Loc. 



AE APPLE II PROGRAMMES *S GUIDE 



MONITOR ROUTINES 



Steps 
On 



F800 AC 



CLRSCR 


F832 


AC,Y 


SCRN 


F871 


AC 


INSTDSP 


F8D0 


ALL 


PRNTYX 


F9M0 


AC 


PRBL2 


F94C 


AC,X 


PREAD 


FB1E 


AC,Y 


SETTXT 


FB39 


AC 


SETGR 


FB40 


AC 


VTAB 


FC22 


AC 


CLREOP 


FC42 


AC,Y 


HOME 


FC58 


AC,Y 


SCROLL 


FC70 


AC,Y 


CLREOL 


FC9C 


AC,Y 


NXTA4 


FCB4 


AC 


NXTA1 


FCBA 


AC 


RDKEY 


FDOC 


AC,Y 


RDCHAR 


FD35 


AC,Y 


GETLN 


FD6A 


ALL 


CROUT 


FD8E 


AC,Y 


PRBYTE 


FDDA 


AC 


COUT 


FDED 


AC.Y 


PRERR 


FF2D 


AC,Y 


BELL 


FF3A 


AC,Y 


RESET 


FF59 


— 


MON 


FF65 


— 


SWEET 16 


F689 


None 



Function 



Plot a point. COLOR contains color in both halves 

of byte ($00-$FF). AC: y-coord, Y: x-coord. 

Clear screen - graphics mode, 

Get screen color. AC: y-coord, Y: x-coord. 

Disassemble instruction at PCH/PCL. 

Print contents of Y and X as H hex digits. 

Print blanks: X is number to print. 

Read paddle. X: paddle number 0-3. 

Set TEXT mode. 

Set GRAPHIC mode (GR). 

VTAB to row in AC (0-$17). 

Clear to end-of-page. 

Home cursor and clear screen. 

Scroll up one line. 

Clear to end-of-line. 

Increment AH (16 bits), then do NXTA1. 

Increment A1 (16 bits). Set carry if result >= A2. 

Get a key from the keyboard. 

Get a key, also handles ESCAPE functions. 

Get a line of text from the keyboard, up to the carriage 

return. Normal mode for Monitor. X returned with number 

of characters typed in. 

Print a carriage return. 

Print contents of AC as 2 hex digits. 

Print character in AC; also works for CR, BS, etc. 

Print "ERR" and bell. 

Print bell. 

RESET entry to Monitor - initialize. 

Normal entry to 'top' of Monitor when running. 

SWEET16 is a 16-bit machine language interpreter. 

[See: SWEET16: The 6502 Dream Machine, Steve Wozniak,] 

[BYTE, Vol. 2, No. 11, November 1977, pages 150-159. ] 



Table 2. 
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Here's what happened: setting the key- 
board to device 5 causes the Monitor to 
install $C500 as the "user-exit" ad- 
dress in KSWH/L. This, of course, is 
the address assigned to I/O Slot 5. 
Since no board is present, a BRK opcode 
eventually occurs; the Monitor prints 
the break and the registers, then reads 
for another command. Since we still 
exit to $C500, the process repeats it- 
self endlessly. Reset removes both 
user exits; you must "re-hook" them 
after every Reset. 

These two exits can enable user editing 
of keyboard input , printer driver pro- 
grams, and many other ideas. Their use 
is limited to your ingenuity. 

Another useful exit is the Control Y 
command exit. Upon recognition of Con- 
trol Y, the Monitor issues a JSR to 
location $03F8. Here the user can pro- 
cess commands by scanning the original 
typed line or reading another. This 
exit is often very useful as a short- 
hand method of running a program. For 
example, when you're going back and 
forth between the Monitor and the Mini- 
Assembler, typing "F666G" is a bit 
tiresome. By placing a JMP $F666 in 
location $03F8, you can enter the 
Mini-Assembler via a simple Control Y. 

Upon being entered from the Monitor at 
$03F8, the registers are garbage. Lo- 
cations A1 and A2 contain converted 
values from the command (if any), and 
an RTS gets you neatly back into the 
Monitor. Figure 1 shows this in more 
detail. 

Figure 1 : Control Y Interface 



Command typed: 

»123U.F5A7Yc 

Upon entry at $03F8, 
the following exists: 



A1L ($3C) contains $34 

A1H ($3D) contains $12 

A2L ($3E) contains $A7 

A2H ($3F) contains $F5 



Hardware Features 

One of the best hardware facilities of 
the Apple-II, the screen display, is 
also the "darkest" - somewhat unknown. 
Here's what I've found out about it. 

The screen buffer resides in memory 
pages 4 through 7, locations $0400 
through about $07F8. The Secondary 
screen page, although not accessed by 
the Monitor, occupies locations $0800 
through $0BF8. Screen lines are not in 
sequential memory order; rather, they 
are addressed by a somewhat complex 
calculation carried out in the routine 
BASCALC. What BASCALC does is to com- 
pute the base address for a particular 
line and save it; whenever the cursor's 
vertical position changes, BASCALC re- 
computes the base address. Characters 
are stored into the screen buffer by 
adding the base address to the cursor's 
horizontal position. 

I haven't made too much use of directly 
storing characters into the screen buf- 
fer; usually just storing new cursor 
coordinates will do the trick via the 
Monitor routines. Be careful, though - 
only change vertical position via the 
VTAB routine since the base address 
must get recomputed! 

Characters themselves are internally 
stored in 6-bit format in the screen 
buffer. Bit 7 ($80), when set, forces 
normal (white-on-black) video display 
for the character. If Bit 7 is reset, 
the character appears inverse (black- 
on-white) video. Bit 6 ($40), when 
set, enables blinking for the charac- 
ter; this occurs only if Bit 7 is off. 
Thus an ASCII "A" in normal mode is 
$81; in inverse mode, $01; in blinking 
mode, $41. 

Reading the keyboard via location $C000 
is easy; if Bit 7 ($80) is set, a key 
has been pressed. Bits 0-6 are the 
ASCII keycode. In order to enable the 
keyboard again, its strobe must be 
cleared by accessing location $C010. 
Since the keyboard is directly access- 
ible, there is no reason you can't do 
"special" things in a user program 
based on some keyboard input - if you 
get keys directly from the keyboard, 
you can bypass ALL of the Control and 
Escape functions. 
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APPLE INTEGER BASIC SUBROUTINE PACK AND LOAD 

Richard F. Suitor 

166 Iremont Street 

Newton, MA 02158 



[Although this article is Copyrighted by The 
COMPUTERIST, Inc., at the authors request 
premission is hereby given to use the subroutine 
and to distribute it as part of other programs.] 

The first issue of CONTACT, the Apple Newslet- 
ter, gave a suggestion for loading assembly 
language routines with a BASIC program. Simply 
summarized , one drops the pointer of the BASIC 
beginning below the assembly language portion, 
adds a BASIC instruction that will restore the 
pointer and SAVEs. The procedure is simple and 
effective but has two limitations. First, it is 
inconvenient if BASIC and the routines are wide- 
ly separated (and is very tricky if the routines 
start at $800, just above the display portion of 
memory) . Second , a program so saved cannot be 
used with another HIMEM, and is thus inconven- 
ient to share or to submit to a software 
exchange . 

The subroutine presented here avoids these diff- 
iculties at the expense of the effort to imple- 
ment it. It is completely position independent; 
it may be moved from place to place in core with 
the monitor move command and used at the new 
location without modification. It makes exten- 
sive use of SWEET 16, the 16 bit interpreter sup- 
plied as part of the Apple Monitor ROM. 

To use the routine from Apple Integer BASIC, 
CALL MKUP, where MKUP is 128 (decimal) plus the 
first address of the routine. The prompt shown 
is "0". Respond with the hex limits of the rou- 
tine to be stored, as BBBB.EEEE (BBBB is the be- 
ginning address, EEEE is the ending; the same 
format that the monitor uses) . Several groups 
may be specified on one line separated by spaces 
or several lines. Type S after the last group 
to complete the pack and return to BASIC. The 
program can now be saved. 

To load, enter BASIC and LOAD. When complete, 
RUN. The first RUN will move all routines back 
to their original location and return control to 
BASIC. It will not RUN the program; subsequent 
RUNS will. 

A LIST of the program after calling MKUP and be- 
fore the first RUN will show one BASIC statement 
(which initiates the restoration process) and 
gibberish. If this is done, RESET followed by 
CTRL C will return control to BASIC. 



WARNING #1 : The routine must be placed in core 
where it will not overwrite itself during the 
Pack. The start of the routine must be above 
HIMEM (e.g. in the high resolution display re- 
gion) or $17A + 4»N + W below the start of the 
BASIC program, where N is the number of routines 
stored and W is the total number of words in all 
of these routines. Also, those routines that 
are highest in memory should be packed first to 
avoid overwriting during pack or restore . Oth- 
erwise it is not necessary to worry about over- 
writing during the restore process; only $1A 
words just below the BASIC program are used . 

WARNING #2: Do not attempt to edit the program 
after calling MKUP. If editing is necessary, 
RUN once to unpack, then edit and call MKUP 
again . 

The routine works as follows. It first packs 
the restore routine just below the BASIC pro- 
gram. It then packs other routines as request- 
ed, with first address and number of bytes 
(words). When S is given, it packs itself with 
the information to restore LOMEM and the begin- 
ning of the BASIC program. The first $46 words 
of the routine form a BASIC statement which will 
initiate the restoration process when RUN is 
typed . 

If a particular HIMEM is needed by the program 
(e.g. for high resolution programs) it must be 
entered before LOADing. The LOMEM will be reset 
by the restoration process to the value it had 
when MKUP was called. 

I do not have a SWEET16 assembler , hence all of 
those op codes are listed as tables of data . In 
the listing, comments indicate where constants 
and relative displacements are differences be- 
tween labels in the routine. 

Some convenient load and entry points are: 



BASO (load) 
hex 

800 

A90 
104C 
2050 
3054 



MKUP (entry) 

hex decimal 

880 2176 

B10 2832 

10CC 4300 

20D0 8400 

30D4 12500 



Editor's Note: While we encourage the use and 
distribution of this subroutine, we do request 
that proper credit be given. Please place the 
following notice on any copies that you make: 

"This PACK & LOAD Subroutine was written by: 
Richard F. Suitor and published in MICRO #6." 
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.DL 


0006 






0070 


HIMS 
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LUDNIG VON APPLE II 

Marc Schwartz 

220 Everit Street 

New Haven, CT 06511 



Owners of the Apple II know from the demonstrat- 
ion tapes that the Apple can make sounds. Not 
all know that it can make music. Having prepar- 
ed a horse racing program, I decided that it 
would be fitting to start out the game with the 
bugle call heard at the track. The following 
program does just that! 

A few words of explanation are in order. The 
series of "pokes" in lines 30 to 240 set up a 
musical tone subroutine that is called in line 
460. 

Each note is represented by a four digit code in 
A$. The first three digits of the code deter- 
mine the note, and the last digit determines the 
the length of the note. Line 410 decodes the 
first three digits by converting each digit to 
ASCII (Apple ASCII), subtracting 176 from each 
to give three numbers , from zero to nine , and 
then multiplying the first number by the second 
and adding the third. This is one of many poss- 
ible ways of generating all the numbers from 
zero to a large number (ninety in this case) 
using single digits. 

Line 420 takes the number just generated and 
subtracts it from forty. This is done because 
the subroutine as written is a bit confusing if 
you want to make music , since the tones go up as 
the numbers go down. This step corrects for 
that. 

Line 440 determines how long each tone will be. 
As "ASC(A$(Z + 3) - 176)" increases, the note 
lengthens: a "1" produces a very short note, and 
a "6" makes a very long note . For some reason , 
higher tones come out more brief than lower 
tones . 

Line 450 determines the tempo. A larger number 
speeds up the tune; a smaller one slows it down. 
Tempo numbers can go from 1 to 255. 

When the program reaches line 470, it returns to 
line 400 to begin decoding the next four digits 
and playing the next note. 

I don't think that Chopin would need to worry 
about competition from anyone using this pro- 
gram, but it is fun to have a musical computer. 



THE APPLE II BUGLE CALL 



10 REM MAKING MUSIC WITH THE APPLE II 


20 DIM A$(255) 


30 POKE 


2,173 


40 POKE 


3,48 


50 POKE 


4,192 


60 POKE 


5,165 


70 POKE 


6,0 


80 POKE 


7,32 


90 POKE 


8,168 


100 POKE 


9,252 


110 POKE 


10,165 


120 POKE 


11,1 


130 POKE 


12,208 


140 POKE 


13,4 


150 POKE 


14,198 


160 POKE 


15,24 


170 POKE 


16,240 


180 POKE 


17,5 


190 POKE 


18,198 


200 POKE 


19,1 


210 POKE 


20,76 


220 POKE 


21,2 


230 POKE 


22,0 


240 POKE 


23,96 



300 A$="001 10071521 1720172017201" 

310 A$(25)="521 1521 1521 10071521 100710012" 

400 FOR Z=1 TO LEN(A$)-3 STEP 4 

410 Z1=(ASC(A$(Z))-176)»(ASC(A$(Z+1))-176) 

+ASC(A$(Z+2))-176 
420 Z2=40-Z1 
430 POKE 0,Z2 

440 POKE 24,ASC(A$(Z+3))-176 
450 POKE 1,75 
460 CALL 2 
470 NEXT Z 
480 END 
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MACHINE LANGUAGE USED IN 
"LUDMIG VON APPLE II" 



R. (Chuck) Carpenter W5US3 
2228 Montclair Place 

Carrollton, TX 
Carrollton, TX 75006 



As an Apple II owner, I found the art- 
icle "Ludwlg von Apple II" (by Marc 
Schwartz, MICRO #2, page 19) quite in- 
teresting. The machine language rou- 
tine used by Marc is put into the BASIC 
program by use of the POKE statement 
and I was curious to see the type of 
program used to activate the Apple II 
on- board speaker. To do this, I con- 
verted the decimal values used for the 
POKE statements into HEX with my TI 
Programmer. Then I loaded the values 
into the computer using the system mon- 
itor commands that are part of the 
Apple II functions. 

Once I had the program loaded, I used 
the monitor commands to list an assem- 
bled version of the routine, as shown 
in Figure 1 . The assembler provides a 
listing of the program and the mnemon- 
ics used with the machine language op- 
codes. This made it easier to deter- 
mine what was happening in Marc's pro- 
gram. At this point I wanted to see 
what would happen if I ran the program 
by itself - as a machine language rou- 
ine only. 



0000- 


0F 






111 




0001- 


00 






BRK 




0002- 


AD 


30 


CO 


LDA 


$C030 


0005- 


A5 


00 




LDA 


$00 


0007- 


20 


A8 


FC 


JSR 


$FCA8 


000A- 


A5 


01 




LDA 


$01 


oooc- 


DO 


on 




BNE 


$0012 


000E- 


C6 


18 




DEC 


$18 


0010- 


F0 


05 




BEQ 


$0017 


0012- 


C6 


01 




DEC 


$01 


0014- 


4C 


02 


00 


JMP 


$0002 


0017- 


60 






RTS 




0018- 


00 






BRK 




0019- 


00 






BRK 




00 1 A- 


05 


4B 




ORA 


$4B 


00 1 C- 


B6 


00 




LDX 


$00, Y 


001E- 


OF 






111 




001F- 


08 






PHP 




0020- 


00 






BRK 




0021- 


28 






PLP 








Figure 


1. 





Because it is somewhat easier to call 
the routine from a BASIC routine, I en- 
tered the BASIC routine shown in Figure 
2. This way I could also change the 
values stored in memory location $0000 
by using the POKE statement. To init- 
ialize the beginning of the routine, I 
entered a value of $05 into location 
$0000. According to Marc, this would 
produce a high frequency output tone 
and this turned out to be the case. 

Now that I had everything set up, I was 
curious to see why the duration of 
playing time is not the same for the 
different tones. To start with, I en- 
tered the program with 3 different val- 
ues at location $0000. As I ran the 
program I timed the length of playing 
with a stop watch. The value of 5 
played for .18 min., 10 played for .45 
min. and 15 played for .85 min. This 
was in agreement with Marc's findings. 
As it turns out, the length of time a 
particular frequency plays is a func- 
tion of the duration of a cycle. The 
output continues for a number of cycles 
and the shorter cycles (higher frequen- 
cies) get done sooner. To get the cor- 
rect musical timing you would need to 
include variable delay time for each 
note played. (The time between zero 
crossings adds up to the same total 
time per note . ) 



>LIST 

10 POKE 0,5 
99 END 

>CALL 2 

>10 POKE 0,10 
>RUN 

>CALL 2 

>10 POKE 0,15 
>RUN 

>CALL 2 



Figure 2. 
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APPLAYER MUSIC INTERPRETER 

Richard F. Suitor 

166 Tremont Street 

Newton, MA 02158 



There have been several routines for 
making music with the APPLE II, includ- 
ing one in MICRO and one in the APPLE 
documentation. The program described 
here is more than a tone-making rou- 
tine, it is a music interpreter. It 
enables one to generate a table of 
bytes that specify precisely the half- 
tone and duration of a note with a sim- 
ple coding. Its virtue over the sim- 
pler routines is similar to that of any 
interpreter (such as Sweet 16, or, more 
tenuously, BASIC) over an assembler or 
hand coding - it is easier to achieve 
one's goal and easier to decipher the 
coding six months later. 

The immediate motivation for this in- 
terpreter was Martin Gardner's Mathe- 
matical Games Column in the April 1978 
Scientific American. Several types of 
algorithmically generated music are 
discussed in that column; this program 
provides a means of experimenting with 
them as well as a convenient method of 
generating familiar tunes. 

The program is written in 6502 assembly 
language . It would be usable on a sys- 
tem other than the APPLE if a speaker 
were interfaced in a similar way. Ac- 
cessing a particular address (C030) 
changes the current through the APPLE 
speaker from on to off or from off to 
on; it acts like a push button on/ off 
switch (or, of course, a flip-flop). 
Thus this program makes sound by acces- 
sing this address periodically with an 
LDA C030. Any interface that could 
likewise be activated with a similar (4 
clock cycles) instruction could be 
easily used. A different interfacing 
software procedure would change the 
timing and require more extensive mod- 
ification. 

The tone is generated with a timing 
loop that counts for a certain number 
of clock cycles, N (all of the cycles 
in a period including the toggling of 
the speaker are counted). Every N 
cycles a 2M bit pattern is rotated and 
the speaker is toggled if the high or- 
der bit is set. Four cycles are wasted 
(to keep time) if the bit is not set. 
There is a severe limit to the versa- 
tility of a waveshape made from on/off 
transitions, but tones resembling a 



variety of (cheap) woodwinds and pipes 
are possible, with fundamentals ranging 
from about 20 Hz to 8 KHz. 

Applayer interprets bytes to produce 
different effects. There are two types 
of bytes: 



Note bytes 
Control bytes 



Bit 7 Not Set 
Bit 7 Set to 1 



A note byte enables one to choose a 
note from one of 16 half tones, and 
from one to eight eighth notes in dur- 
ation. The low order nybble is the 
half-tone; the high order nybble is the 
duration (in eighth notes) minus one. 

Bit 7 6 5 4 3 2 10 
Note Byte (Duration) (Half-Tone) 

The control bytes enable one to change 
the tempo, the tonal range which the 16 
half-tones cover, rests, the waveshape 
of the tone and to jump from one por- 
tion of the table to another. 
Control Byte Table 

HEX DECIMAL FUNCTION 

81 129 The next three bytes are 

the new waveshape pattern 

82 130 JMP - New table address 

follows. Low order byte 
first , then page byte 

83 131 JSR - new table address 

follows. When finished, 
continuing this table at 
byte after address byte 

9N 14M+N N is the number of 16th 

notes to be silent at the 
tail of a note. Controls 
rests and note definition 

AN 160+N<32 Selects the tonal range. 
Half-tone #0 is set to 
one of 32 half-tones giv- 
ing a basic range of four 
octaves 

CN 192+N<62 Controls the tempo. Len- 
gth of a note is propor- 
tional to N. Largest 
value gives a whole note 
lasting about 3-5 sec. 

FF 255 RETURN. Stop interpret- 
ing this table. Acts as 
return for 83 JSR in- 
struction or causes re- 
turn from Applayer. 
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To use Applayer with sheet music, one 
must first decide on the range of the 
half tones. This must sometimes be 
changed in the middle of the song. For 
example, the music for "Turkey in the 
Straw", which appears later, was in the 
key of C; for the first part of 
the song I used the following table. 

NOTE CDEFGABCD 
TONE #0 2U579BCE 

The tonal range was set with a control 
byte, BO. In the chorus, the range of 
the melody shifts up; there the tonal 
range is set with a B7 and the table is 

NOTE GABCDEFGA 
TONE# 024 5 79ACE 

(The actual key is determined by the 
wave shape pattern as well as the tonal 
range control byte. For the pattern 
used, 05 05 05, the fundamental for the 
note written as C would be about 346Hz, 
which is closer to F.) 

Rests can be accomplished with a 9N 
control byte and a note byte. For ex- 
ample, 94 10 is a quarter rest, 98 30 
is a half rest etc. This control is 
normally set at 91 for notes distinct- 
ly separated, or to 90 for notes that 
should run together. 

Let's try to construct a table that 
Applayer can use to play a tune. We 
can start simply with "Twinkle, Twinkle 
Little Star". That tune has four lines 
the first and fourth are identical , as 
are the second and third. So our table 
will be constructed to: 

1. Set up the tonal range, tone pat- 
tern and tempo that we want 

2. JSR to a table for the first line 

3. JSR to a table for the second line 

4. Repeat #3 

5. Repeat #2 

6. Return 

7. First line table and return 

8. Second line table and return 



Since unfortunately Applayer is not 
symbolic, it will be easier to con- 
struct the tables in reverse, so that 
we can know where to go in steps 2-6. 
The note table for the first line can 
go at 0B00 and looks like: 

0B00- 10 10 17 17 19 19 37 15 
0B08- 15 14 14 12 12 30 FF FF 

The second line can follow at 0B10: 

0B10- 17 17 15 15 14 14 32 FF 

Now we can start on step 1. I'll sug- 
gest the following to start; you'll 
want to make changes: 

0B20- B0 81 05 05 05 E0 91 

The above determines the tonal range, 
the tone wave shape, the tempo, and a 
sixteenth note rest out of every note 
to keep the notes distinct. To run 
them together, use 90 instead of 91. 
Steps 2-6 can follow immediately: 

0B20- 83 

0B28- 00 0B 83 10 0B 83 10 0B 
0B30- 83 00 0B FF 

That completes the table for "Twinkle, 
Twinkle". We now have to tell Applayer 
where it is and turn it on. From BASIC 
we must set up some zero page locations 
first and then JSR to Applayer: 
(Don't forget to set LOMEM before run- 
ning; 2900 will do for this table.) 



100 POKE 19,32 

110 POKE 20,11 

120 POKE 1,8 

130 POKE 17,8 



140 POKE 
120 CALL 



16,0 
2346 



(low order byte of the 

table address, 0B20) 
(high order byte of the 

table address, 0B20) 
(high order byte of 1st 
pg of Applayer program) 

(16 & 17 contain the 
tone table address) 

(jump subroutine to 
092A) 
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We can also make a short program in as- 
sembly language to set up the zero page 
locations. See routine ZERO, location 
09C0 in the listing. 

This initialization can be used most 
easily by reserving the A00 page, or 
much of it, as a "Table of Contents" 
for the various note tables elsewhere 
in memory. To do this with "Twinkle, 
Twinkle" we add the following table: 

0A20- 82 20 OB 

Which jumps immediately to the table at 
0B20. With this convention, we can 
move from table to table by changing 
only the byte at 9D0 (2512 decimal). 



0A00: 



03 90 OF 83 90 OF FF 



0F00 


: 90 1C 


1A 


92 


38 


90 


18 


1A 


0F08 


: 18 13 


10 


11 


91 


13 


13 


33 


0F10 


: 33 90 


18 


1A 


92 


3C 


3C 


90 


0F18 


: 1C 1A 


18 


1A 


91 


1C 


38 


18 


0F20 


: 38 90 


1C 


1A 


92 


38 


90 


18 


0F28 


: 1A 18 


13 


91 


10 


11 


13 


53 


0F30 


: 33 90 


18 


1A 


91 


3C 


3F 


90 


OF38 


: 1F 1C 


18 


1A 


1C 


18 


92 


3A 


0F40 


: 94 78 


91 


FF 










0F50 


81 55 


55 


55 


FF 








0F58 


81 05 


05 


05 


FF 








0F60 


15 18 


18 


15 


78 


FF 






0F68 


16 1A 


1A 


16 


7A 


FF 






0F70 


1D 1D 


1D 


1D 


18 


18 


18 


18 


0F78: 


35 15 


15 


33 


90 


11 


13 


91 


0F80: 


15 18 


18 


18 


90 


18 


15 


11 


0F88: 


13 91 


15 


15 


13 


13 


71 


FF 


0F90: 


83 58 


OF 


D4 


BO 


83 


50 


OF 83 


0F98: 


B7 83 


60 


OF 


83 50 


OF 


83 


0FA0: 


60 OF 


83 


50 


OF 


83 


68 


OF 


0FA8: 


83 50 OF 83 


68 


OF 


83 


50 


0FB0: 


OF 83 


70 


OF 


FF 









We can use this initialization from 
BASIC, too, by changing the last in- 
struction to RTS: 



100 POKE 2512,32 
110 POKE 2538,96 
120 CALL 2496 

From the monitor: 

will do. 



LOW ORDER TABLE BYTE 
CHANGE INST. AT 09EA 
TO RTS. 



*9D0:20 
*9C0G 



If, as I, you quickly tire of "Twinkle, 
Twinkle", you may wish to play with 
"Turkey in the Straw". The table fol- 
lows; its structure will be left as an 
exercise. 



From the monitor: 
will play it. 



*9D0:0 
•9C0G 







Tone Table 




0800 


• A0 


03 68 03 38 03 


08 03 


0808 


EO 


02 B8 02 90 02 


68 02 


0810 


48 


02 28 02 08 02 


E8 01 


0818 


DO 


01 B4 01 9C 01 


84 01 


0820 


70 


01 5C 01 48 01 


34 01 


0828 


24 


01 14 01 04 01 


F4 00 


0830 


E8 


00 DA 00 CE 00 


C2 00 


0838 


B8 


00 AE 00 A4 00 


9A 00 


0840 


92 


00 8A 00 82 00 


7A 00 


0848 


74 


00 6D 00 67 00 


61 00 


0850 


5C 


00 57 00 52 00 


4D 00 


0858- 


49 


00 45 00 41 00 


3D 00 
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APPLAYER MUSIC INTERPRETER 

R. F. SUITOR APRIL 1978 

TIMING LOOP 

LOCATIONS THROUGH 7 ARE SET BY CALLING ROUTINE 
8 CYCLE LOOP TIMES Y REG PLUS 0-7 CYCLES 
DETERMINED BY ENTRY POINT 



0860 

0860 EA 

0861 EA 

0862 EA 

0863 88 

0864 85 
0866 DO 
0868 FO 
08 6 A 88 
08 6B EA 
08 6C EA 
08 6D DO 
086F 24 

0871 38 

0872 30 

0874 EA 

0875 18 

0876 26 
0878 26 
087A 26 
087C 90 
087E AD 
0881 C6 
0883 DO 
0885 C6 
0887 DO 

0889 60 
088A EA 
08 8B EA 
088C DO 
088E A4 

0890 6C 



45 
FB 
05 



F4 
04 

02 



02 

03 
04 

03 

30 CO 

06 

05 

07 

05 



00 
05 
00 00 



TIME 



TIMEA 



TIMEB 



TIMEC 



TIMED 



TIMEE 



TIMEF 



TIMEG 



ORG 


$0860 


NOP 




NOP 




NOP 




DEY 




STA 


$0045 


BNE 


TIMEA 


BEQ 


TIMEC 


DEY 




NOP 




NOP 




BNE 


TIMEA 


BIT 


$0004 


SEC 




BMI 


TIMED 


NOP 




CLC 




ROL 


$0002 


ROL 


$0003 


ROL 


$0004 


BCC 


TIMEE 


LDA 


$C030 


DEC 


$0006 


BNE 


TIMEF 


DEC 


$0007 


BNE 


TIMEG 


RTS 




NOP 




NOP 




BNE 


TIMEG 


LDY 


$0005 


JMI 


$0000 



ANY INNOCUOUS 3 CYCLE INSTRUCTION 
BASIC 8 CYCLE LOOP 



START CHECK OF BIT PATTERN 
IN 2, 3, AND 4 



TOGGLE SPEAKER 

DURATION OF NOTE IN 

NO. OF CYCLES IN LOCATIONS 

6 AND 7 



TIMING EQUALIZATION 



SCALING ROUTINE FOR CYCLE DURATION 
CALCULATION LOC 6,7 = A REG * LOC 50,51 



0893 85 45 


SCALE 


STA 


$0045 


0895 A9 00 




LDAIM 


$00 


0897 85 06 




STA 


$0006 


0899 85 07 




STA 


$0007 


089B A2 05 




LDXIM 


$05 


089D 18 




CLC 




089E 66 07 


SCALEX 


ROR 


$0007 


08A0 66 06 




ROR 


$0006 


08A2 46 45 




LSR 


$0045 


08A4 90 OC 




BCC 


SCALEA 



108 



08A6 A5 06 


LDA 


$0006 


08A8 65 50 


ADC 


$0050 


08AA 85 06 


STA 


$0006 


08AC A5 07 


LDA 


$0007 


08 AE 65 51 


ADC 


$0051 


08B0 85 07 


STA 


$0007 


08B2 CA 


SCALEA DEX 




08B3 10 E9 


BPL 


SCALE 


08B5 E6 07 


INC 


$0007 


08B7 60 


RTS 





DUE TO SIMPLE LOGIC IN TIMING ROUTINE 



08BE 



ORG $08BE 



NOTE PLAYING ROUTINE 

Y REG HAS HALF-TONE INDEX 



08BE A5 


12 


08C0 85 


52 


08C2 A5 


OF 


08C4 85 


10 


08C6 B1 


10 


08C8 38 




08C9 85 


54 


08CB E9 


35 


08CD 85 


08 


08 CF C8 




08D0 B1 


10 


08D2 85 


55 


08D4 E9 


00 


08D6 85 


09 


08D8 A9 


00 


08DA 85 


50 


08DC 85 


51 


08DE 85 


53 


08E0 AO 


10 


08E2 20 


86 FB 



NOTE 



LDA 
STA 
LDA 
STA 



$0012 
$0052 
$000F 
$0010 



NOTE LENGTH 

NOTE TABLE OFFSET 

LOW ORDER BYTE OF MACHINE 
CYCLES PER PERIOD 



HIGH ORDER BYTE OF MACHINE 
CYCLES PER PERIOD 



LDAIY $0010 

SEC 

STA $0054 

SBCIM $35 CYCLES USED UP TIMING OVERHEAD 

STA $0008 

INY 

LDAIY $0010 

STA $0055 

SBCIM $00 

STA $0009 

LDAIM $00 

STA $0050 

STA $0051 

STA $005? 

LDYIM $10 

JSR $FB86 



THIS PART IS PARTICULAR TO APPLE. THE DIVIDE 
ROUTINE AT FB86 IS USED. OR, PROVIDE A ROUTINE 
WHICH DIVIDES LOCS 54,55 BY 52,53 AND LEAVES THE 
RESULT IN 50,51 FOR THE SCALING ROUTINE. 



08E5 A5 08 


LDA 


$0008 




08E7 48 


PHA 






08E8 46 09 


LSR 


$0009 




08EA 6A 


RORA 






08EB 46 09 


LSR 


$0009 




08 ED 6 A 


RORA 






08EE 46 09 


LSR 


$0009 




08F0 6A 


RORA 






08F1 85 05 


STA 


$0005 


NO. OF 8 CYCLE LOOPS 


08F3 68 


PLA 






08F4 29 07 


ANDIM 


$07 


LEFT OVER CYCLES DETERMINT 


08F6 AA 


TAX 




ENTRY POINT 


08F7 BD F8 09 


LDAX 


TTABLE 


TABLE OF ENTRY POINTS FOR TIMING LOOP 


08FA 85 00 


STA 


$0000 


109 



08FC A5 


OE 




LDA 


$000E 


NOTE DURATION, QUARTI 


08FE 38 






SEC 






08FF E5 


OD 




SBC 


$000D 


REST PART OF NOTE 


0901 F0 


OF 




BEQ 


NOTEB 


IF NOTHING TO DO 


0903 20 


93 


08 


JSR 


SCALE 


SCALING ROUTINE 


0906 A2 


02 




LDXIM 


$02 


START PATTERN LOAD 


0908 B5 


OA 




NOTEA LDAZX 


$0A 




090A 95 


02 




STAZX 


$02 




090C CA 






DEX 






090D 10 


F9 




BPL 


NOTEA 




090F 20 


6F 


08 


JSR 


TIMEC 


TIMING ROUTINE 


0912 A5 


OD 




NOTEB LDA 


$000D 


REST PART OF NOTE 


0911 FO 


OE 




BEQ 


MAIN 


IF NOTHING TO DO 


0916 20 


93 


08 


JSR 


SCALE 


SCALING ROUTINE 


0919 A9 


00 




LDAIM 


$00 




091B 85 


02 




STA 


$0002 


ZERO OUT PATTERN FOR 


091D 85 


03 




STA 


$0003 


REST PART 


091F 85 


04 




STA 


$0004 




0921 20 


6F 


08 


JSR 


TIMEC 


TIMING 


0924 






ORG 


$0924 





MAIN PART OF INTERPRETER 
ENTRY AT "ENTRY" 



0924 E6 13 
0926 DO 02 
0928 E6 14 



MAIN 



INC 
BNE 
INC 



$0013 
ENTRY 
$0014 



TABLE ADDRESS 



092A AO 00 
092C B1 13 
092E 30 12 

0930 48 

0931 29 OF 

0933 OA 

0934 A8 

0935 68 

0936 29 70 

0938 4A 

0939 4A 
093A 4A 
093B 69 02 
093D 85 OE 
093F 4C BE 08 

0942 C9 FD 
0944 90 01 
0946 60 



ENTRY LDYIM $00 

LDAIY $0013 

BMI MAINA 

PHA 

ANDIM $0F 

ASLA 

TAY 

PLA 

ANDIM $70 

LSRA 

LSRA 

LSRA 

ADCIM $02 

STA $000E 

JMP NOTE 



MAINA 



CMPIM $FD 
BCC MAINB 
RTS 



NEXT TABLE BYTE 
TO CONTROL SECTION 

TONE 



DURATION 



TOTAL DURATION IN 16THS 

PAY NOTE 

CO + 3D IS LONGEST NOTE FOR 
FOR SCALING REASONS 



0947 48 

0948 OA 

0949 10 07 
09 4B 68 
094C 29 
094E 85 



MAINB 



3F 
12 



0950 BO D2 



PHA 

ASLA 

BPL 

PLA 

ANDIM $3F 

STA 

BCS 



MAINC 



$0012 
MAIN 



NOTE LENGTH 



UNCONDITIONAL BRANCH 



110 



0952 


0A 




MAINC 


ASLA 






0953 


10 


08 




BPL 


MAIND 




0955 


68 






PLA 






0956 


29 


1F 




ANDIM 


$1F 


TONAL RANGE INDEX 


0958 


OA 






ASLA 






0959 


85 


OF 




STA 


$000F 




095B 


90 


C7 




BCC 


MAIN 


UNCONDITIONAL BRANCH 


095D 


OA 




MAIND 


ASLA 






09 5E 


10 


07 




BPL 


MAINE 




0960 


68 






PLA 






0961 


29 


OF 




ANDIM 


$0F 


REST FRACTION 


0963 


85 


OD 




STA 


$000D 




0965 


90 


BD 




BCC 


MAIN 


UNCONDITIONAL BRANCH 


0967 


OA 




MAINE 


ASLA 






0968 


10 


03 




BPL 


MAING 




096A 68 




MAINF 


PLA 






096B 


90 


B7 




BCC 


MAIN 


DUMMY, CONTROLS NOT INTERPR 


09 6D 


OA 




MAING 


ASLA 






09 6E 


30 


FA 




BMI 


MAINF 




0970 


OA 






ASLA 






0971 


10 


2B 




BPL 


MAINI 




0973 


68 






PLA 






0974 


AA 






TAX 




JSR AND JMP SECTION 


0975 


4A 






LSRA 






0976 


90 


OA 




BCC 


MAINH 




0978 


A5 


13 




LDA 


$0013 


JSR SECTION, PUSH RETURN TA 


09 7 A 


69 


01 




ADCIM 


$01 


ADDRESS ON TO STACK 


097C 


48 






PHA 






097D 


A5 


14 




LDA 


$0014 




097F 69 


00 




ADCIM $00 




0981 


48 






PHA 






0982 


C8 




MAINH 


INY 






0983 B1 


13 




LDAIY 


$0013 


GET NEW ADDRESS 


0985 


48 






PHA 






0986 C8 






INY 






0987 


B1 


13 




LDAIY 


$0013 




0989 


85 


14 




STA 


$0014 




09 8B 


68 






PLA 






098C 


85 


13 




STA 


$0013 




098E 


8A 






TXA 




AND STORE IT FROM BEGINNING 


09 8F 


4A 






LSRA 




OF SELECTION 


0990 


90 


98 




BCC 


ENTRY 


JMP 


0992 


20 


2A 09 




JSR 


ENTRY 


JSR 


0995 


68 






PLA 






0996 


85 


14 




STA 


$0014 


PULL ADDRESS AND STORE IT 


0998 


68 






PLA 






0999 


85 


13 




STA 


$0013 




099B 


18 






CLC 






099C 


90 


86 




BCC 


MAIN 


UNCONDITIONAL BRANCH 


099E 


68 




MAINI 


PLA 






09 9F 


AO 


03 




LDYIM 


$03 


GET NEW PATTERN AND 


09A1 


B1 


13 


MAINJ 


LDAIY 


$0013 


STORE IT 



111 



09A3 99 


09 


00 


STAY $0009 




09A6 88 






DEY 




09A7 DO 


F8 




BNE MAINJ 




09A9 A5 


13 




LDA $0013 




09AB 69 


03 




ADCIM $03 


JUMP OVER PATTERN 


09AD 85 


13 




STA $0013 




09AF 90 


02 




BCC MAINK 




09B1 E6 


14 




INC $0014 




09B3 4C 


24 


09 


MAINK JMP MAIN 




09 CO 






ORG $09C0 
INITIALIZATION FOR 


ZERO PAGE 


09C0 D8 






ZERO CLD 


JUST IN CASE 


09C1 A9 


00 




LDAIM $00 




09C3 85 


10 




STA $0010 




09C5 A9 


08 




LDAIM $08 




09 C7 85 


11 




STA $0011 




09C9 85 


01 




STA $0001 




09CB A9 


OA 




LDAIM $0A 




09CD 85 


14 




STA $0014 


NOTE TABLE PAGE 


09CF A9 


20 




LDAIM $20 




09D1 85 


13 




STA $0013 


NTOE TABLE BYTE 


09D3 A9 


01 




LDAIM $01 




09D5 85 


OD 




STA $000D 


REST 16THS 


09D7 A9 


20 




LDAIM $20 




09D9 85 


12 




STA $0012 


NOTE LENGTH, CONTROLS TEMPO 


09DB A9 


20 




LDAIM $20 




09DD 85 


OF 




STA $000F 


TONAL RANGE INDEX 


09DF A9 


05 




LDAIM $05 




09E1 85 OA 




STA $000A 


WAVE SHAPE PATTERN 


09E3 85 


OB 




STA $000B 




09E5 85 


OC 




STA $000C 




09E7 20 


2A 


09 


JSR ENTRY 


TO APPLAYER 


09EA 4C 


69 


FF 


JMP $FF69 


TO MONITOR, AFTER THE BEEP 



09F8 



09F8 63 
09F9 6A 
09 FA 62 
09FB 6D 
09FC 61 
09FD 6C 
09FE 60 
09FF 6B 

ENTRY 
MAINC 
MAING 
MAINK 
SCALE 
TIMEB 
TIMEF 



ORG $09F8 
TABLE OF ENTRY POINTS FOR TIMING ROUTINE 



TTABLE = 



$63 
$6A 
$62 
$6D 
$61 
$6C 
$60 
$6B 



092A 
0952 
096D 
09B3 
0893 
086A 
088A 



MAIN 0924 

MAIND 095D 

MAINH 0982 

NOTE 08BE 

SCALEA 08B2 

TIMEC 086F 

TIMEG 088E 



MAINA 0942 

MAINE 0967 

MAINI 099E 

NOTEA 0908 

TIME 0860 

TIMED 0876 

TTABLE 09F8 

112 



MAINB 0947 

MAINF 096A 

MAINJ 09A1 

NOTEB 0912 

TIMEA 0863 

TIMEE 0881 

ZERO 09C0 



APPLE ii STARNARS THEME 

Hnarew n. Eliason 

28 Charles Lane 
Falmouth, MA 025A0 



Just for the fun of it, here are some routines 
to create something which sounds like the main 
battle scene from STARWARS. Enjoy! 

Apple II Startrek Sounds Routine 
Dis-assembler Listing 
•3FA1L 



3FA1- 


AO 


0E 


LDY 


#S0E 


3FA3- 


A2 


00 


LDX 


#$00 


3FA5- 


8A 




TXA 




3FA6- 


18 




CLC 




3FA7- 


E9 


01 


SBC 


#$01 


3FA9- 


DO 


FC 


BNE 


13FA7 


3FAB- 


8D 


30 CO 


STA 


SC030 


3FAE- 


E8 




I NX 




3FAF- 


EO 


SC 


CPX 


#$8C 


3FB1- 


DO 


F2 


BNE 


$3FA5 


3FB3- 


88 




DEY 




3FB4- 


DO 


ED 


BNE 


$3FA3 


3FB6- 


60 




RTS 




3FB7- 


00 




BRK 




3FB8- 


00 




BRK 




3FB9- 


00 




BRK 




3FBA- 


00 




BRK 




3FBB- 


00 




BRK 




3FBC- 


00 




BRK 




3FBD- 


00 




BRK 




* 











Load via monitor starting at 3FA1: 



3FA1.3FB6 



0E A2 8A 18 E9 
DO FC 8D 30 CO E8 E0 



3FA1- A0 
3FA8- 01 
3FB0- 
» 

doer BASIC and set HIMEM: 16288 
Enter this program s>n<j RUN: 



8C DO F2 88 DO ED 60 



LIST 



>LIST 

10 PRINT "STAR BATTLE 
20 1= RND (15)+1: REM 
30 J= RND (1 1 >*1 0+1 20 
40 POKE 16290>I: POKE 
50 CALL 16289 
60 N= RND (1000): FOR 
70 GOTO 20 
999 END 



SOUND EFFECTS" 

SHOTS 
! REM DURATION 
16304, J 

K=l TO N: NEXT K 



Try I = RND(30)+1 and J = RNDC255). 

The above material is based on the "Phaser" 
sound effect from Apple II Startrek. 
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SHAPING UP YOUR APPLE 

Michael Faraday 
246 Bronxville Road 
Bronxville, NY 107D8 



Even though, as a programming novice, it took me 
a while to take on Apple II 's Hi-Resolution 
Graphics I have to admit that the seeming com- 
plexity of constructing a Shape Table held a 
certain fascination for me from the first time I 
opened the Reference Manual. With Gary Dawkin's 
delightful program appearing in Creative Com- 
puting recently there is no longer any real 
need to apply the original technique , but a good 
understanding of something never hurt anyone , if 
only to verify other working arrangements. 

If you have a TI Programmer, or any convenient 
way of converting from one base to another, 
here's a simplified method of untangling that 
unsightly jumble of arrows and binary digits on 
page 53 of the "Big Red Book". The key is in 
recognizing that the conversion chart is nothing 
more than an OCTal representation of our 8-bit 



A/B C 



OCT 



4 


000 


00 





To the Code list we 
will add the OCTal 




001 


01 


1 


number that each 


4 








arrow represents. 


010 


10 


2 






011 


11 


3 




i 


100 

101 




4 
5 




T 


110 

111 




6 

7 





byte . OCTal is binary broken into groups of 
three just as HEX is binary broken into groups 
of four. The fog lifts a little and we can now 
see why the "C" digit is limited to two bits: we 
only have a total of eight to start with. Look- 
ing a little further along the same page we come 
to the Conversion Codes and it's here we can 
begin to make things really easy. 



c 


B 


A 


C B A 






1 

1 1 1 


1 

1 1 1 







1 





i » 


1 


1 


1 


*i 1 





1 1 


1 1 


•* W 



To the Code list we will add the OCTal number 
each arrow represents . 

Going back to the original example in the manual 
we can replace the entire chart of binary digits 
with an OCTal number put directly above our "un- 
wrapped" arrows , like so : 

OCT 227704441555266637 

Shape J J— *-f f f }■»••>- ' — f J f }***- 



We are going to construct either two- or three- 
digit numbers from this list and now come the 
only rules required to deal with in the whole 
procedure: 

1 . While always trying to make a three-digit 
number, the "last" digit of a three-digit group 
can ONLY be a 1 , 2 or 3 (remember that the "C" 
digit is only 2 binary digits, which can repre- 
sent the OCTal number three at most) . 

2. As usual, these numbers appear Least Signif- 
icant Digit first and therefore the "last" digit 
is, in reality, the first digit of the new OCTal 
number . 

So we can now divide the long string of numbers 
into two- and three-digit , reverse-order OCTal 
numbers with slashes : 

OCTal 2 2/7 7/0 4/4 4 1/5 5/5 2/6 6/6 3/7 
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"unwrap" this list, reversing digits as we go, 
and converting to HEX: 



OCT 

22 

77 

40 

144 



HEX 

12 
3F 
20 
64 



Even this can be a bit tedious and since I find 
the arrow Code conversion very easy to remember 
- No Plot, Up Clockwise to Left = to 3; Plot, 
Up Clockwise to Left = 4 to 7 - I draw my dia- 
grams on graph paper using these OCTal numbers 
only. 



Thus, 



t ♦ 

t + * 
t i * 



becomes 



15 5 5 2 
4 6 

4 2 6 
4 2 6 
7773 



Some caveats. It's still a good idea to draft 
an original diagram with plain dots just to get 
the shape and scale to your liking. This also 
becomes a handy guide for the debugging you're 
almost certain to have to do. And too, it makes 
great fun for your non-computer friends who 
might like to play Connect- the-Dots after a cou- 
ple of beers. 

A big problem keeps cropping up using the scale 
feature. It seems that when blowing up the 
original drawing the Apple II uses the direction 
of motion associated with the plotted points as 
a base reference for the additional points. 
This often leads to strangely assymetrical pic- 
tures in larger scale with "lines" of dots going 
in unexpected directions. As always, a little 
playing around can really make you feel good. 
Have fun. 



Hexidecimal - Octal Conversion Table 



HEX 









1 


2 


3 


4 


5 


6 


7 


10 


11 


12 


13 


14 


15 


16 


17 


1 


20 


21 


22 


23 


24 


25 


26 


27 


30 


31 


32 


33 


34 


35 


36 


37 


2 


40 


41 


42 


43 


44 


45 


46 


47 


50 


51 


52 


53 


54 


55 


56 


57 


3 


60 


61 


62 


63 


64 


65 


66 


67 


70 


71 


72 


73 


74 


75 


76 


77 


4 


100 


101 


102 


103 


104 


105 


106 


107 


110 


111 


112 


113 


114 


115 


116 


117 


5 


120 


121 


122 


123 


124 


125 


126 


127 


130 


131 


132 


133 


134 


135 


136 


137 


6 


140 


141 


142 


143 


144 


145 


146 


147 


150 


151 


152 


153 


154 


155 


156 


157 


7 


160 


161 


162 


163 


164 


165 


166 


167 


170 


171 


172 


173 


174 


175 


176 


177 


8 


200 


201 


202 


203 


204 


205 


206 


207 


210 


211 


212 


213 


214 


215 


216 


217 


9 


220 


221 


222 


223 


224 


225 


226 


227 


230 


231 


232 


233 


234 


235 


236 


237 


A 


240 


241 


242 


243 


244 


245 


246 


247 


250 


251 


252 


253 


254 


255 


256 


257 


B 


260 


261 


262 


263 


264 


265 


266 


267 


270 


271 


272 


273 


274 


275 


276 


277 


C 


300 


301 


302 


303 


304 


305 


306 


307 


310 


311 


312 


313 


314 


315 


316 


317 


D 


320 


321 


322 


323 


324 


325 


326 


327 


330 


331 


332 


333 


334 


335 


336 


337 


E 


340 


341 


342 


343 


344 


345 


346 


347 


350 


351 


352 


353 


354 


355 


356 


357 


F 


360 


361 


362 


363 


364 


365 


366 


367 


370 


371 


372 


373 


374 


375 


376 


377 
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BROWN AND WHITE AND COLORED ALL OVER 

Richard F. Suitor 

166 Tremont Street 

Newton, MA 02158 



This article consists of two parts. The first 
is a brief discussion of the colors of the Apple 
and their relationships to each other and to the 
color numbers . Some of that information is used 
in the second part to generate a random color 
display according to certain principles sugges- 
ted by Martin Gardner in his mathematical games 
column in Scientific American. 

The Color of Your Apple 

The color of your Apple comes from your color 
TV. The video signal has many components. Most 
of the signal carries the brightness information 
of the picture - a black and white set uses this 
part of the signal to generate its picture. 
Superimposed on this signal is the "color car- 
rier:, a 3.58 MHz signal that carries the color 
information. The larger tnis signal, the more 
colorful that region of the picture. The hue 
(blue, green, orange, etc.) is determined by the 
phase of the color signal. Reference timing 
signals at the beginning of each scan line syn- 
chronize a "standard" color signal. The time 
during a 3.58 MHz period that the picture color 
signal goes high compared to when the standard 
goes high determines the hue. A color signal 
that goes high when the standard does gives or- 
ange. One that goes low at that time gives 
blue. Signals that are high while the standard 
goes from high to low or from low to high give 
violet and green. (This, at least, was the in- 
tention. Studio difficulties, transmission 
paths and the viewers antenna and set affect 
these relations, so the viewer is usually given 
final say with a hue or tint control . ) 

The time relation of the color signal to the 
standard signal is expressed as a "phase angle", 
is measured in angular measures such as degrees 
or radians and can run from to 360 degrees. 
This phase angle corresponds to position on a 
color circle , with orange at the top and blue at 
the bottom, as shown in Figure 1. 

The perimeter of the circle represents different 
colors or hues. The radial distance from the 
center represents amount of color, or satura- 
tion. The former is usually adjusted by the 
tint control , the latter by the color control . 
A color that can be reproduced by a color TV can 
be related to a point in this circle . The angu- 
lar position is coded in the phase of the 3.58 
MHz color carrier signal; the radial distance 
from the center is given by the amplitude of the 
color carrier. 

The numerical coding of the Apple colors can be 
appreciated using this circle and binary repre- 
sentation of the color numbers. The low order 
bit corresponds to red (#1). The second bit 
corresponds to dark blue (#2) , the third to dark 
green (#4) and the high order bit to brown (dark 
yellow, #8). To find the color for any color 
number , represent each 1 bit as a quarter-pie 
piece centered over its respective color, as in- 
dicated in Figure 1 . The brightness or light- 
ness of the color corresponds to the number of 
pie pieces and the color corresponds to the 
point where the whole collection balances. 
Black, #0, has no bits set, no pie and no 
brightness. White, #15, has four bits set, the 
whole pie , is of maximum brightness and balances 
in the center of the circle at neutral . Orange , 



#9 or 1001 in binary, has pie over the top hemi- 
sphere and balances on a point between neutral 
and orange. The #5, binary 0101, has two sepa- 
rate wedges , one over red and one over green . 
Since it is symmetric, it balances at the cen- 
ter. It represents a neutral gray of intermedi- 
ate brightness. So does the #10. The #14 has 
pie over every sector except the red one . It *is 
bright and balances on a line toward forest 
green. It gives a light, somewhat bluish green. 



ORANGE 



YELLOW 



GREEN 

FOREST 
GREEN 



RED 




VIOLET 



DEEP 
BLUE 



MID BLUE 

Figure 1 . 

Color circle shows relations of 
color to color number bit position. 

A diagram representing the relations of all the 
colors is given in Figure 2. Each of the one, 
two and three bit numbers form planes , each cor- 
responding to a color circle. One can think of 
these positions as points in space, with bright- 
ness increasing with vertical position and hori- 
zontal planes representing color circles of 
differing brightness. 

The colors of the Apple are thus coded by the 
bit patterns of the numbers representing them. 
You can think of them as additive combinations 
of red, dark blue, dark green and brown, where 
adding two colors is represented by ORing the 
two numbers representing them. Subtractive com- 
bination can be represented by ANDing the light 
colors, pink, yellow, light green and light 
blue. The more bits set in a number, the 
brighter; the fewer, the darker. The bit pat- 
terns for 5 and 10 have no 3.58 MHz component 
and so generate a neutral tone. At a boundary 
between 5 and 10 however, this pattern is dis- 
turbed and two bits or spaces adjoin. Try the 
following program which has only grays disp- 
played : 



TO 9 
EOT! = 5 
40 HLIN 0,39 AT 2*1 
50 VLIN 20,39 AT 2*1 
60 VLIN 20,39 AT 2*1+21 
70 COLOR = 10 
80 HLIN 0,39 AT 2*1 + 1 
90 VLIN 20,39 AT 2*1 + 1 
100 VLIN 20,39 AT 2*1 + 20 
110 NEXT I 
120 RETURN 

The top half of the display has HLIN's, alter- 
nating 5 and 10. The bottom half has VLIN's, 
alternating 5 and 10. What do you see? The bit 
pattern for a number is placed directly on the 
video signal, with the four bits occupying one 
color carrier period. When two bits adjoin at a 
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.1111 



0011 
VIOLET 



0001 
RED 




DARK BLUE 



0000 
BLACK 



0100 
DARK GREEN 



Figure 2. 

Color space locations of the Apple II colors. 

Each horizontal plane forms a color circle 

of different brightness. 



5,10 boundary, a light band is formed. When two 
spaces adjoin, a dark band is formed. The 
slight tints are due to the boundaries having 
some color component. Changing the 5,10 order 
reverses this tint . 

Now is perhaps a good time to consider just how 
large a 3.58 MHz period is. The Apple text is 
generated with a 5x7 dot matrix, a common method 
of character generation. These same dots cor- 
respond to individual bits in the high resolu- 
tion display memory. One dot is one-half of a 
3.58 MHz period and corresponds to a violet (#3) 
or green (#12) color signal. This is why the 
test is slightly colored on a color TV and the 
high resolution display has two colors (other 
than black and white), green and violet. (But 
you can make others, due to effects similar to 
those seen in the BASIC program above . ) 

(The design of color TV has further implications 
for the display. The video black and white sig- 
nal is limited to about 4 MHz, and many sets 
drop the display frequency response so that the 
color signal will not be obtrusive. A set so 
designed will not resolve the dots very well and 
will produce blurry .text. Some color sets have 
adjustments that make the set ignore the color 
signal. Since the color signal processing in- 
volves subtracting and adding portions of the 
signal , avoiding this can sometimes improve the 
text resolution. Also reducing the contrast 
especially and the brightness somewhat can help 
with text material.) 

The color TV design attempts to -remove the color 
carrier from the picture (after duly providing 
the proper color) , but you may be able to see 
the signal as 3 or 4 fine vertical lines per 
color block. They should not be apparent at all 
in the white or black or either gray (except 
possibly on a high resolution monitor) . 



Tan is Between Brown and White 

This section presents a brief application of the 
concepts of the relationships in color space of 
the Apple colors. Many of you, I suspect, are 
regular readers of Martin Gardner's "Mathemati- 
cal Games" column in Scientific American. I 
strongly recommend it to those of you who have 
not already been introduced. It publicized 
"Life" (MICRO 5:5) and motivated "Applayer" 
(MICRO 5:29), and was the motivation for this 
program. There's a lot of gold in the mine yet. 

In April , the column discussed the aesthetic 
properties of random variations of different 
kinds. To summarize briefly, three kinds are: 

WHITE Each separate element is chosen randomly 
and is independent of every other ele- 
ment . Called "white" because a fre- 
quency spectrum of the result shows all 
frequencies occur equally, a qualitative 
description of white light. 

BROWN Each separate element is the previous 
element plus a randomly chosen devia- 
tion. Called "brown" because Brownian 
montion is an example. 

1/F So called because of its frequency 

spectrum, intermediate between "white" 
and "brown" . 

The column presented arguments, attributed to 
Richard Voss, that 1/f variations are prevalent 
and aesthetically more satisfying than "white" 
(not enough coherence) or "brown" (not enough 
variation) . An algorithm was given for generat- 
ing elements with 1/f random variations. Brief- 
ly, each element is the sum of N terms (three, 
say) . One term is chosen randomly for each ele- 
ment . The next is chosen randomly for every ot- 
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her element . The next is chosen randomly for 
every fourth element , and so forth . 



With the Apple, one can experiment with these 
concepts aurally (hence Applayer) and visually 
with the graphic displays. Color is a dimen- 
sion that was not discussed much in the column. 
This section presents an attempt to apply these 
concepts to the Apple display. 

Most of us know what "white" noise is like on 
the Apple display. An exercise that many try is 
to choose a random point , a random color , plot 
and repeat . For example : 

10 GR 

20 X = RND(40) 

30 Y = RND(40) 

40 COLOR = RNDC16) 

50 PLOT X,Y 

60 GOTO 20 

Dispite the garish display that results, this is 
a "white" type of random display. Except for 
all being within certain limits, the color of 
one square has no relationship to that of its 
neighbors and the plotting of one square tells 
nothing about which square is to be plotted 
next. 



To implement the concept of 
following : 



'1/f", I used the 



1 . X and Y are each the sum of three numbers , 
one chosen randomly from each plot , one every 20 
plots and the third every 200. 



2. A table of color numbers was made (DIM(16) 
in the program) so that color numbers near each 
other would correspond to colors that are near 
each other. The choice given in the program 
satisfies the following restrictions : 

a. Adjacent numbers are from adjacent 
planes in Figure 2. 

b. No angular change (in the color planes) 
is greater than 45 degrees between 
adjacent numbers. 



3. The color number is the same for 20 plots 
and then is changed by an amount chosen randomly 
from -2 to +2. This is a "brown" noise genera r 
tion concept. However, most of the display 
normally has color patches that have been gene- 
rated long before and hence are less correlated 
with those currently being plotted. I'll claim 
credit for good intentions and let someone else 
calculate the power spectrum. 

4. Each "plot" is actually eight symmetric 
plots about the various major axes. I can't 
even claim good intentions here; it has nothing 
to do with 1/f and was put in for a kaleidoscope 
effect. Those who are offended and/ or curious 
can alter statement 100. They may wish then to 
make X and Y the sum of more than three terms, 
with the fourth and fifth chosen at even larger 
intervals. 

The program follows. A paddle and push buttons 
are used to control the tempo and reset the dis- 
play. If your paddle is not connected, substi- 
tute for PDL(0). 



>LIST 

1 DIM ft CI 6> •■ fl CI > = : fl <£> =£ : ft 03 
} =6 : fl (A) =7 : fl C5> =3 : fl (.&> = 1 : ft (. 
7>=5:FK8>=11 
£ H <9> =9 : fl CI 0) =8 : ft C 1 1 } = 1 : fl < 1 £ 
>=13:fld3>=15:fl<14>=14:fl<15 
:J=l£:flC16>=4 
10 GDTD 3 000 
100 PLOT XjY: PLOT 38-XjY: PLOT 
Xj38-Y: PLDT 38-X>38-Y: PLOT 
Y-X: PLOT 38-Yj38-X: PLDT Y? 
38-X: PLDT 38-YjX 
110 RETURN 
1£0 Z=16 

1£5 L= RND <5>-£ 
130 U= RND C9>:V= RND <9:> 
147 FDR E=l TD 10 
150 R=IJ+ RND <9>!S=V+ RND <9> 
155 IF PEEK C-16£86>>1£7 THEN GR 

160 K=K+I_: IF K>16 THEN K=K-Z 
165 IF K<0 THEN K=K+Z 



170 CDLDR=ft (K> 

180 Q=( PDL <:0;'.-£> '- £ 

190 FDR I=-Q TD Q: IF PEEK <-16£87 

> > 1 £7 THEN £ : NEXT I 
£00 FDR 1=1 TD £0 
£10 X=R+ RND <6>:Y=S+ RND <6> : GDSUB 

100: NEXT I 
££0 NEXT E 
£30 GDTD 1£0 
1010 K=l:l_=5 
10£0 Z=16 
£000 GDTD 1£0 
3000 GR : CALL -936 
3010 PRINT "PADDLE CONTROLS PATTERN 

SPEED" 
30S0 PRINT "USE BUTTON TD GD AT DNC 

E TO HI SPEED" 
3030 PRINT "HOLD BUTTON 1 TD CLEAR SC 

REEN" 
3040 GDTD 1010 
9 END 

>CftLL 358 
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ME "RE NUMBER ONE! 

An Editorial 

We're number one in microcomputer systems. With over twelve thousand KIM-1 
microcomputers in the field and a thousand per month being ordered, plus a 
good number of Apple I and Apple II systems, plus a variety of OSI units, 
plus the Jolts, Data Handlers, and other 6502-based systems, plus the huge 
numbers of PETs and Microminds that have been ordered, plus a lot of home- 
brew 6502 systems - it all adds up to a tremendous number of 6502-based 
microcomputer systems in use throughout the world. Adding to this number 
are the one and one-half million 650x chips purchased by Atari for some of 
their games. We've come a long way in the past year. 

We're number one in microprocessor power. Microchess for the KIM-1 took 
1.1K and for the 8080A took about 2.5K. Of thirty-one BASICs tested and 
reported in Kilobaud , the four 6502 versions placed in the top five spots, 
yielding only second place to the Z-80 running at 4 MHz. The 6502 's many 
addressing modes make it very efficient and easy to program. 

We're number one in user participation. Maybe there is some process of 
"natural selection" which attracts individuals who are industrious, able, 
cooperative, adventurous and communicative to the 6502. While users of 
other microprocessor chips have been "spoonfed" via company supported 
user notes and user libraries, the 6502 users have been "doing their own 
thing" as evidenced by the activity level of many local 6502 groups and 
the success of the KIM- 1/6502 User Notes . 

We're number one since this is our first issue. We would like to really 
become the most useful journal in the whole microcomputer field, not the 
largest, just the best. We are undertaking the venture with the conviction 
that there is a need for a journal to help bring all of the separate parts 
of the 6502 world together and with the belief that 6502 users will each 
do what they can to support the effort. 
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COMPUTER CONTROLLED RELAYS 



Robert M. Tripp 

P.O. Box 3 

S. Chelmsford, MA 01824 



One of the easiest ways to expand the capabili- 
ties of a KIM-1 system is to provide a means of 
turning cassette tape recorders on and off under 
program control. This added capability permits 
a KIM-1, without a lot of additional memory, 
to perform editing, program assembly, mailing 
list maintenance, information retrieval, and 
other useful functions. One method of adding 
this computer control is by using relays as 
shown in the diagram below. To work reliably, 
a few components are required besides the 
relays. 

The 7404 Hex Inverter is used to buffer the 
signals from the KIM's 6530 Port B I/O lines. 
There are many other IC chips which can also 
perform the buffering function. The 7404 was 
selected because it is so readily available. 

The clipping diodes on the coils of the relays 
are there to prevent a reverse voltage spike, 
generated when the relay is turned off, from 
damaging the buffer chip. Note that some 
relays may come with this diode already built- 
in. 

The resistor on the contact side of the relay 
serves to limit the current drawn from the de- 
vice connected to the relay. This is required 
where the device does have a current source, 
such as the "remote" switch in most cassette 
tape recorders. 



The capacitor on the contact side of the relay 
serves to dump excess current that may occur 
during the initial surge when the relay makes its 
closure. Without this capacitor, many relays will 
have their contacts "welded" shut after a few 
operations. 

Note that the contact side of relays which do 
not carry significant current do not require 
either the resistor or capacitor. 

The KIM-1 circuitry is such that during a READ 
operation a signal is also present on the AUDIO 
OUT lines. This will cause a problem on tape 
recorders whose electronics are not turned off 
in the "remote" state, since the record head is 
active and the signal being generated by the 
READ will be written on the tape. This can 
wipe out data on the tape. A solution is pro- 
vided by a third relay which is connected in 
parallel with the WRITE REMOTE relay and 
which is used to control the AUDIO OUT line. 
The record head is now active only when the 
WRITE REMOTE is selected. The AUDIO OUT 
line should also be brought out to another 
phono jack for use when writing tape using 
the normal KIM-1 Dump routine which does not 
know about the relays. 
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6502 INTERFACING FOR BEGINNERS: 
ADDRESS DECODING I 

Marvin L. De Jong 

Dept. of Math-Physics 

The School of the Ozarks 

Point Lookout, MO 65726 



This is the first installment of a col- 
umn which will appear on a regular 
basis as long as reader interest, auth- 
or enthusiasm and the editor's approval 
exist. Your response will be vital for 
our deciding whether to continue the 
column. Do not be afraid to be criti- 
cal or to make suggestions about what 
subjects you would like to see. Hope- 
fully, the column will be of interest 
to anyone who owns a 6502 system. One 
of the more challenging aspects of be- 
ing a computer hobbyist is understand- 
ing how your system works and being 
able to configure and construct I/O 
ports. Then one can begin to tie his 
computer to the outside world. Perhaps 
this column will give you the ability 
to produce flashing lights, clicking 
relays, whirring motors, and other re- 
markable phenomena to amaze your fri- 
ends and make your mother proud. 

An educational column has to make some 
assumptions about where the readers are 
in terms of their understanding. A fa- 
miliarity with binary and hex numbers 
will be assumed, as will a nodding ac- 
quaintance with the 7^00 series of in- 
tegrated circuits. Lacking such a 
background I would recommend that you 
get a book like "Bugbook V" by Rony, 
Larsen, and Titus; "TTL Cookbook" by 
Lancaster; or an equivalent book from 
your local computer shop or mail order 
house. Ads in "Micro", "Byte", 
"Kilobaud", "Ham Radio", "73 Magazine", 
etc. will list places where both books 
and parts may be ordered. My own pre- 
ference for "hands-on" experience would 
be "Bugbook V". Although this book has 
some material on the 8080A chip, most 
of the material is very general and the 
chapters covering the basic 7^00 series 
integrated circuits are very good. An- 
other indispensable book is the "TTL 
Data Book" published by Texas Instru- 
ments. 

It would be a good idea to get a Proto 
Board or equivalent breadboarding sys^ 
tem for the experiments which will be 
suggested. One can even find wire kits 
to go with the breadboards. I would 
not purchase all the Outboards from E & 
L Instruments since the same circuits 
can be constructed less expensively 



from parts. Please regard these sug- 
gestions as opinions which may not be 
shared by all experimenters. 

Finally, let me introduce the column by 
saying that the title is not "Interfac- 
ing Made Easy". If it were easy there 
would be no challenge and no need for 
this column. Like mountain climbing, 
satisfaction comes from overcoming the 
difficult rather than achieving the ob- 
vious. The material which you see in 
this column will usually be something 
which I am in the process of learning 
myself. I am a hobbyist like yoursel- 
ves: I keep the wolf from the door by 
teaching mathematics and physics, not 
computer science or digital electron- 
ics. Expert opinions from readers and 
guest contributions will always be wel- 
come. 

We begin at the beginning. The 6502 
pins may be divided into four groups: 
power, address, data, and control pins. 
Pins 1 and 21 are grounds, and pin 8 is 
connected to the +5V supply, making the 
power connections. Pins 9 through 20 
and 22 through 25 are connected to the 
address bus on the microcomputer, while 
the data pins, 26 through 33. are con- 
nected to the data bus. All of the re- 
mainder of the pins may be lumped in 
the general class of control pins. In 
subsequent issues the data bus and the 
control bus will be discussed. Our 
concern in the first two issues is with 
addressing. 

The 6502 Address Bus 

The 6502 receives data from a variety 
of devices (memory, keyboard, tape 
reader, floppy disc, etc.), processes 
it, and sends it back to one or more 
devices. The first process is called 
READ and is accomplished by the LDA or 
similar instruction. The last process 
is called WRITE and is achieved by a 
STA type instruction. The purpose of 
the address pins is to put out a signal 
on the address bus to select the 
device or location which is going to 
produce or accept the data. In the 
computer system, each device has a 
unique address, and when the 6502 puts 
that address on the address bus, the 
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device must be activated. Each line 
on the address bus may have one of two 
possible values (high or low, H or L, 
1 or 0, +5V or 0V are the names most 
frequently given to these values). A 
one-address-line system could select 
two devices; one activated by a on 
the address line, the other by a 1 . 
Figure 1 shows how to decode such an 
idiot microcomputer. 



ao—£> 




Device 2 



evice 1 



Figure 1. Decoding a One-Address Line 
Microprocessor. 



Any device which when connected to the 
address bus puts out a unique signal 
(1 or 0) for a unique address is called 
a decoder. We have seen that a micro- 
computer with a single address line can 
select two devices, which could be 
memory locations or I/O ports. A some- 
what smarter microprocessor might have 
two address lines. It could be decoded 
by the device shown in Figure 2, pro- 
vided the truth table of the device 
were the one given in Table 1. Such a 
device could be implemented with NAND 
OR NOR gates, or with a 74139. 




— JS— Device 4 
— £>— Device 3 
— [N-Device 2 
— |^>-Device 1 



The point is that two address lines 
allow the microprocessor to select four 
devices; three address lines give eight 
devices;, four, 16; five, 32; six, 64; 
and so oh. The 6502, being very smart, 
has 16 address lines. Anyone who can 
calculate how many telephones can be 
"addressed" by a 7-digit, base-ten 
phone number can also calculate how 
many locations can be addressed by a 16 
digit, base-two address bus, The 
answers are 1 ' = 10 million and 
2 '=65,536, respectively. 

Earth people have not yet made a 
single device to simultaneously decode 
16 address lines to produce 65,536 
device select signals. Such a monster 
IC would need at least 65,554 pins. 
Many integrated circuits are con- 
structed to decode the ten, low-order 
address lines (A0-A9) internally. For 
example, the 6530 PIA chips on the 
KIM and the 21L02 memory chips on my 
memory board decode the ten lowest 
address lines internally, that is, they 
select any one of the 2 to =1024 flip- 
flops to be written to or read. Con- 
sequently, our problem is to decode the 
high-order address lines, at least 
initially. These lines are usually de- 
coded to form blocks of address space 
(not unlike home addresses in city 
blocks) . Three address lines give 
eight (2^=8) possible blocks, and the 
three highest address lines (A15-A13) 
divide the address soace into eight 
blocks, each having 2® b ~ a '' =' /3 in«- 
tions. 



=2 /J loca- 



Figure 2. 74139 Decoder for a Two- 
Address Line Microprocessor. 



Now 1024 ( 1024=2'°) locations is usual- 
ly referred to as 1K, so 2 ,a locations 
is 2 3 x 2'° locations, which is 8 x 2 /e 
locations, which is 8K locations. Thus 
the top three address lines divide the 
address space into eight, 8K blocks. 
See Table 2 for more details. Each of 
these 8K blocks may be further divided 



Inputs 
A B 


Outputs 
1 2 


3 


L L 
L H 
H L 
H H 


L H H 
H L H 
H H L 
H H H 


H 
H 
H 
L 



Table 1. Truth Table for Two-Line 
Decoder 74139- 
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A14 
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Hex Addresses 











8K0 


0000- 1FFF 








1 


8K1 


2000-3FFF 





1 





8K2 


4000-5FFF 





1 


1 


8K3 


6000-7FFF 


1 








8K4 


8000-9FFF 


1 





1 


8K5 


A000-BFFF 


1 


1 





8K6 


C000-DFFF 


1 


1 


1 


8K7 


E000-FFFF 



Table 2. "Blocking" the Memory Space. 



124 



into 1K blocks by decoding address 
lines A12-A10. Table 3 shows how block 
8K4 is divided into eight, 1K blocks. 
Finally, as mentioned before, many de- 
vices decode the lowest 10 address 
lines, and consequently we have decoded 
all 16 address lines, at least on 
paper . 
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K32 


8000-83FF 








1 


K33 


8400-87FF 





1 





K34 


8800-8BFF 





1 


1 


K35 


8C00-8FFF 


1 








K36 


9000-93FF 


1 





1 


K37 


9400-97FF 


1 


1 





K38 


9800-9BFF 


1 


1 


1 


K39 


9C00-9FFF 



Table 3- Subdivision of 8K4 Block into 
1K blocks. 



To begin to see how this is done, con- 
struct the circuit shown in Figure 3. 



1 . Load the following program somewhere 
between 0100 and 1FFF. The program 
is relocatable. 



0200 18 

0201 8D XX 60 
0204 9° FB 



LOOP 



CLC 

STA 60XX 

BCC LOOP 



This routine stores Accum. in location 
60XX. X means "don't care." Then loop 
back. 



2. Run the program and with the wire 

probe shown in Figure 3, test each of 

the output pins (pins 1-7 and 9). 

Which ones cause the LED to glow? 



3. Try to explain your results with the 
help of the truth table, Table 4. 



4. Change the STA instruction to a LDA 
instruction (AD XX 60) and repeat steps 
2 and 3 above. 
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9_ 100 ohms 

6 Wire Probe 
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7 
6 
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3 EI 
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^Computer Ground 

Figure 3. Decoding the Highest Three 
Address Lines. 



(There are many decoding schemes and 
circuits, the circuit of Figure 3 is 
just one possible technique.) Here 
is where your breadboard becomes 
useful. Connect the address lines from 
your 6502 system to the 74145. (KIM 
owners can do this with no buffering 
because lines A15-A13 are not used on 
the KIM-1. Owners of other systems 
should check to see if the address 
lines are properly buffered.) Now per- 
form the following experiments: 



5. In turn, change the location at 
which you are getting the data to a 
location in each of the 8K blocks in 
Table 2, e.g. 00XX, 20XX, 40XX, etc. 
and test the output pins on the 74145 
to see if the LED glows. You should be 
able to explain your results with the 
truth table. 



6. Stop the program and check the 
pins again. 
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H 


H 


H 


H 


L 


H 


H 


H 


H 


H 


H 


H 


H 


H 


H 


H 


L 



Table 4. Truth Table for 74LS145 when 
connected as shown in Figure 3. 
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In steps 2 and 4 the LED should glow 
when the probe touches pin 1 and pin 4. 
Why does it glow more brightly on pin 
1? When the program is stopped, only 
pin 1 should cause the LED to light. 
The answers to these questions and the 
answers to questions you never asked 
will be given in the next issue. 

What else is coming up in the next 
coluan? We will see how to take any 
of the 8 signals from the 74145 to 
enable a 74LS138 which in turn will 
decode address lines A12-A10, thus 



dividing any 8K block of address space 
which we may select into 1K blocks. 
Into one of these IK blocks we will put 
some I/O ports. 

(The more precocious of my attentive 
readers may already see that the scheme 
of Figure 3 could also be used to pre- 
set or clear a flip-flop to control an 
external device, for example, a heater, 
and all that without even using the 
data lines. If you see all that, you 
can take over this column.) See you 
next issue . 



126 



6502 INTERFACING FOR BEGINNERS: 
ADDRESS DECODING II 

Marvin L. De Jong 

Dept . of Math-Physics 

The School of the Ozarks 

Point Lookout, MO 65726 



I hope you did not turn any expensive integrated 
circuits into cinders with last month's experi- 
ments. We will begin this month by considering 
the questions raised in the last column. You 
will need to refer to the circuits, tables, and 
the program described there. The following 



table describes the activity which takes place 
on the address bus and the data bus while the 
program is running. It is organized by clock 
cycles, each one microsecond long, starting with 
the op code fetch of the CLC instruction. 



CYCLE ADDRESS BUS 




1 
2 
3 

5 
6 

7 

u 



0200 
0201 
0201 
0202 
0203 
60XX 
0204 
0205 
0206 



A15 












Alt 





1 






A13 






1 







DATA BUS 



COMMENTS 



CLC op code Pin 1 of LS145 is low because address 

lines A13-15 are low. 
STA op code LED will glow when connected to pin 1„ 

but not to other pins. 
STA op code All other pins on LS145 are high. 



XX 

60 



Low order address of storage location 

on data lines. 

High order address of storage location 

on data lines, 
accumulator LED will light for 1 microsecond if 
contents connected to pin 4 on LS145. 
BCC op code Pin 4 high, pin 1 low. LED will glow 

on pin 1 only. 
FB offset 6502 is now determing if and where to 

branch. Branch is to 0201 because 
garbage carry was clear. 



In the program loop address lines A14 and A13 go 
high only during cycle 5. Thus, for six cycles 
output (pin 1) of the LS145 is low. The LS145 
is an open collector device and acts like a 
switch to ground when the pin is in the L state, 
allowing current to flow through the LED. Dur- 
ing cycle 5, when the address of the storage 
location is on the address bus, pin 4 is in the 
low state and will cause the LED to glow. Earth 
people do not perceive one microsecond flashes 
spaced six microseconds apart, so the LED ap- 
pears to glow rather than flash. Since the ma- 
jority of the loop time is spent with pin 1 at 
logic 0, a bright glow is observed on this pin. 
Changing the instruction from STA to LDA has no 
effect since the address bus goes through the 
same sequence for a LDA as it does for a STA. 
Changing the storage location from 60XX to some- 
thing else will cause another pin of the LS145 
to glow. The results of the LED test should 
agree with the truth table given for the LS145. 

The pulse from the decoder which occurs when it 
responds to a particular address at its input 
pins is called a device select pulse or an 
address select pulse. The LS145 produces a 
logic or active-low device select pulse, some- 
times symbolized by ~l r or DS. This pulse is 

used to select or activate or enable another de- 
vice in the computer system such as a memory 
chip, an 1/0 port, a PIA chip, or another deco- 
der. As mentioned in the last column, the de- 
vice select pulse from the LS145 could be used 
to enable a 74LS138 which would then decode ad- 
dress lines A10-12, dividing an 8K block into 1K 
blocks . Such a scheme is very similar to the 
expansion circuit suggested in the KIM-1 USER 
MANUAL, page 74. Similar circuits are also 



used on memory expansion boards. In the present 
circumstance I have decided to make a trade-off 
between wasting address space and minimizing the 
number of chips on the breadboard. Our purpose 
here is to configure some I/O ports as simplv as 
possible. 

The decoding circuit is shown in Figure 1 . A 
total of eight device select pulses are avail- 
able for eight 1/0 ports. Note that one of the 
8K selects (8K4) from the LS145 enables the 
LS138 which decodes the three low-order address 
lines. All of the 8K4 space is used to get 
eight 1/0 ports. Using a 74LS154 instead of the 
LS138 and decoding on more address line would 
give 16 1/0 ports in the event we need more. Or 
we could take another 8K select to enable anoth- 
er LS138 or LS145, giving us 8 or 32 ports, re- 
spectively. There is no doubt that address 
space is being wasted, but few users use all 
64K, or even 32K, so the waste may be justified. 
In Figure 1, address lines AO-2 are extended 
downward to indicate that they could be decoded 
by other devices such as an LS138 or LS154. 

The add_resses which enable the device select 
pulses DS0-7 are given in Figure 1 . Note that 
since not all sixteen lines have been decoded to 
produce the pulses, the addresses shown are not 
the only ones which will work. For example, de- 
vice select pulse will be produced whenever 
the computer reads or writes to 8XX0 or 9XX0 (XX 
means any hex numbers) . This should cause no 
difficulty unless we try to put other devices 
into the 8K4 block, in which case we could sim- 
ply decode some other lines. If your system 
does not buffer the address lines, you should 
buffer them with the circuit shown in Figure 2. 
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A0A1 A2 

99 9 



A13o 
A140 
A15o 



o +5v 




Figure 1 . 

jit to Sel« 
See text for details. 



Hex 
Address 

.s 8000 



5 

5 « 


8001 


3* 3 


8002 


3 ,2 


8003 


3 " 


8004 


3 ,0 


8005 


, <> 


8006 


V^- 


&007 .. 






to 



■v 

c 



SI 

3 



Decoding Circuit to Select 1/0 Ports. 



Construct the circuits of Figures 1, 2, and 3. 
I managed to get them on one A P circuit board 
with no difficulty, with room for several more 
chips. I also found that the A P breadboard 
jumper wire kit is very handy for making neat 
layouts. Connect one of the device select lines 
from the LS138 to the flip-flop preset input 
(Test Circuit, Figure 3) and another device se- 
lect line to the clear input. A pulse to the 
preset input will cause the Q output to go high, 
lighting the Q LED, whereas a pulse to the clear 
input will cause the "5~ output to go high, light- 
ing the Q LED. 

To test your decoding circuit write a one state- 
ment program, for example: 



0200 AD 00 80 



LDA DS0 



If the line labeled 8000 is connected to the 
preset of the test circuit, the Q output will go 
high, lighting the LED, when the program is run. 
Running the program: 



0200 AD 04 80 



LDA DS4 



will cause a switch of the flip-flop if the line 
8004 is connected to the clear input. You 
should test all 8 device select lines from the 
LS138 with these programs by changing the con- 
nections and the addresses. Note that no data 
is being transferred since we have made no con- 
nections to the data bus. It should also be ap- 
parent that this scheme could be used to switch 
a motor, light, cassette recorder or other de- 
vice off and on in a computer program. Eureka! 
We have made a simple 1/0 circuit. 

To continue a little further, repeat the above 
experiments with a STA instruction replacing the 
LDA instruction. The results should be identi- 
cal because in both cases it is the address of 



the device select on the address bus which 
produces the pulse which flips the flop. One 
more experiment: connect the R/W line from the 
6502 to the G1 input on the LS138 after remov- 
ing the connection from G1 (pin 6) to pin 16. 
Now try the programs above, using first a LDA 
instruction, then a STA instruction. You should 
find that the program with the LDA instruction 



9 +5v 



A0o 

AlO 
A2o 

A13n> 

A 14o 

Al5o 




OAO 
OA1 
OA2 
OA13 

OA14 
OA15 



Figure 2. 

Buffering the Address Lines. 

The arrows pointing into the chip are the 

lines from the 6502, while those pointing 

away go to the circuit in Figure 1. 
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+5v 




Figure 3. Test Circuit. 



works, that is, the lights can be switched from 
off to on and vice versa, but the STA instruc- 
tion does not work. Why? 

Keep your circuit, as the material in the next 
column will refer to and make use of the circuit 
you have just completed. 

A Note About Figure 1 : The « lines in Figure 1 
suggest that something should be done with them. 
For the experiments described above, nothing 
need be connected to these lines, however when 



An Additional Experiment 



\ 



we try to put data on the data bus these lines 
will become important. What you do depends on 
the system you are using. Since the KIM-1 is 
probably the most popular system among the read- 
ers, and since my own system is a KIM (expanded 
with a Riverside KEM and MVM-1024) the following 
details will be of most interest to KIM owners. 
Owners of other systems will have to dig into 
their manuals to make sure they are not de-se- 
lecting their on-board devices, or much worse, 
selecting two devices to put information on the 
data bus simultaneously. The KIM-1 has a 74145 
decoder on-board which decodes lines A10-12; 
lines A13-15 are not decoded. Consequently, the 
lowest 8K0 block is already decoded, and the de- 
vice select pulse from the LS145 in Figure 1 
should enable the decoder on the KIM for all ad- 
dresses in the 8K0 block. To do this simply 
connect the device select pulse from pin 1 on 
the 74LS145 in Figure 1 to pin K on the appli- 
cation connector on the KIM, making sure that 
the ground connection is first removed. A 10K 
pull-up resistor between pin 1 and +5V will also 
be necessary. The device select pulse from 8K7 
should enable the device containing the restart 
and interrupt vectors. In the case of the KIM, 
pin 9 of the LS145 in Figure should enable the 
6530-002 ROM by connecting it to pin J of the 
application connector. No pull-up is necessary. 

Next issue we will examine the other pins on the 
6502 which will be useful in configuring I/O 
ports, namely the bi-directional data bus, and 
the control signals. Hopefully we shall finish 
the circuitry needed to make an output port (8 
bits) , connect some LEDs to it , see if it works 
or smokes, and maybe think of a use for it. 

A couple of parting shots: First, there is a 
very good educational series of articles in 
KILOBAUD magazine called KILOBAUD KLASSR00M. 
It assumes less experience than I have assumed 
so far. Second, I hope you have obtained a "TTL 
Databook" from either Texas Instruments or 
National so that you can study the truth tables 
and other specifications of the chips we are 
using . 



The address decoding circuit of Figure 1 pro- 
duces a one microsecond negative going one-shot 
pulse when a LDA instruction addresses one of 
the locations shown in Figure 1 . This one-shot 
can be used for a variety of purposes, one of 
which is triggering the flip-flop shown in Fig- 
ure 3. The program listed below makes use of an 
interval timer (KIM-1 system addresses) to pro- 
duce a square wave . By varying the time loaded 
into the timer, the frequency can be changed, 



and the duty cycle can be changed. Thus, we 
have produced a simple function generator with 
programmable period and duty cycle. The LEDs 
will show the results at low frequencies. Try 
this program and watch the LEDs. Amplify the Q 
output and connect it to a speaker; notice the 
effect of changing the time, the duty cycle, the 
wave shape (by filtering) or whatever else you 
can think of. Notice that I used device selects 
8007 and 8001 . 







DSEVEN 


• 


$8007 






DS0NE 


• 


$8001 






TIMER 


• 


$1707 






CLKRDI 


• 


$1707 


0200 AD 07 


80 


START 


LDA 


DSEVEN 


0203 A9 FF 






LDAIM $FF 


0205 8D 07 


17 




STA 


TIMER 


0208 AD 07 


17 


BACK 


LDA 


CLKRDI 


020B 10 FB 






BPL 


BACK 


020D AD 01 


80 




LDA 


DS0NE 


0210 A9 FF 






LDAIM $FF 


0212 8D 07 


17 




STA 


TIMER 


0215 AD 07 


17 


AGN 


LDA 


CLKRDI 


0218 10 FB 






BPL 


AGN 


021A 4C 00 


02 




JMP 


START 



DEVICE SELECT 7 
DEVICE SELECT 1 
KIM TIMER 
KIM CLOCK DONE TEST 

INIT DS7 DEVICE SELECT PULSE 

INIT TIMER 

START DIVIDE-BY-1024 TIMER FOR 256 

CYCLES, NOW CHECK TO SEE IF IT 

IS FINISHED. IF NOT, CHECK AGAIN, 

OTHERWISE TRIGGER DS1. 

START TIMER FOR SECOND HALF OF 
CYCLE. IS TIMER READY? 
NO, CHECK AGAIN, OTHERWISE JUMP 
TO START OVER. 
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TYPESETTING OINI A 6502 SYSTEM 

Robert M. Tripp 

P.O. Box 3 

S. Chelmsford, MA 01824 



As Editor/Publisher of MICRO, I was 
bothered by the need to have typeset- 
ting done by an outside company for 
several reasons. First, of course, was 
the cost. A typeset page can cost from 
$12 to $30.00. Second, it takes time 
have a page set, anywhere from one to 
five days. Third, once you have the 
typeset material and are ready to paste 
up the final copy, it is very difficult 
to make any changes or corrections. It 
occurred to me that I should be able to 
do a reasonable job of typesetting with 
my existing equipment - a KIM-1 and a 
Diablo Hytype II based terminal. The 
results of my efforts are described in 
this article, and, this entire issue of 
MICRO has been produced with the equip- 
ment and program described. 

Actually, "typesetting" is a misnomer 
for what is being done here, "type" is 
not being "set". Justification would 
probably be a better term, but still 
would not completely cover the features 
currently implemented. For lack of a 
term, I named this routine "JUSTIFY". 



Features of Justify 

JUSTIFY has four modes. The most use- 
ful is Full Justification in which a 
line is set justified at both the left 
and right margins. The lines you are 
reading now are an example of a Full 
Justification. In this mode the width 
of the column is specified as a param- 
eter to the JUSTIFY routine which then 
pads the text as necessary to make the 
text exactly meet the right margin. 

The second mode is No Justification. 
There are a number of instances in 
which you do not want the material to 
be justified: the last line of a para- 
graph, source listings, object list- 
ings, any type of tables, and so forth. 
The following listing makes the point 
quite graphically: 



0120 A6 DB 
0122 B5 00 
0124 CA 



JSTIFY LDXZ CMND 
LDAZX $00 
DEX 



which, if set with Full Justification 
would come out as 



0120 A6 DB 
0122 B5 00 
124 CA 



JSTIFY 



LDXZ CMND 

LDAZX $00 

DEX 



Obviously not what was intended. 

The third mode is Center. Title blocks 
of articles, headers for sections, and 
so forth need to be centered. The Cen- 
ter mode calculates where to start the 
text so that it will be properly cen- 
tered, including spliting a character 
space in half to get perfect centering. 

A 

AA 
AAA 

The last mode currently implemented is 
actually not a form of justification, 
but is useful. It is an enhancement 
in which characters may be printed 
slightly bolder than the surrounding 
text to make them stand out. This mode 
is independent of the three justifica- 
tion modes and can be combined with any 
of them. 

Although the JUSTIFY routine was made 
for typesetting MICRO, we have found it 
has many other uses. Since the editing 
portion of the program permits you to 
make corrections before printing, we 
can type "perfect" letters. 

Justification Algorithm 

The justification algorithm, or rules, 
used is based on certain characteris- 
tics of the Diablo printer. This 
printer "thinks small" - it divides the 
line into units which are 1/120th of an 
inch. Each printed character is nor- 
mally 10 units wide, including the 
space around the character, giving 12 
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characters per inch. In TEXT mode, 
there is no way to space the characters 
other than next to each other as in 
regular typing, or separated by a full 
space. If this was the only method of 
positioning characters, then the justi- 
fication would consist of expanding the 
spaces in a line to pick up the extra 
units to justify a line. This is the 
method required for a teletype printer. 
It looks like this: 

This is teletype mode justification. 

Note that the spaces between words has 
been doubled in the first three posi- 
tions. This is not too bad, and as 
long as there are not too many spaces 
to distribute, can be acceptable. 
Given the Diablo 1 s capability of pad- 
ding with as little as a space of 1/120 
of an inch, much better justification 
be achieved. If there are only a few 
units to be distributed over the line, 
then each normal space may be stretched 
just a little. For example, in a line 
which is only one character short of 
full, there are only ten units of space 
remaining to be distributed, since each 
character is 10 units wide. If the 
line contained five normal spaces, then 
each space would be stretched by two 
units, an almost imperceptible amount. 

Full justification with an extra unit. 
Full justification with no extra units. 

As the number of units to be distribu- 
ted increases, there comes a point at 
which the spaces become noticeably 
wide. The way this can be solved on 
the Diablo is to distribute spaces 
among the characters as well as the 
spaces. The calculation is done as: 



1. 
2. 



3. 



4. 



Count number of extra units. 
If there are more units than 
characters and spaces, then 
add one or more units to each 
character and space. 
If there are fewer units than 
characters and spaces, then 
test just the spaces. If 
there are more units than 
spaces, then add one or more 
to each space. 

When there are finally fewer 
units than spaces, distribute 
the remaining units over the 
first spaces in the line. 



Each character has one unit added. 
Characters have not had a unit added. 

Close inspection will reveal that the 
first line above has the individual 
characters spaced slightly wider than 
the second line. This algorithm will 
handle most normal lines, but if a line 
has too many units to fill, it will 
look strange. 

This is a very loose line. 

The JUSTIFY Function 

JUSTIFY is written in the form of a 
HELP Function. HELP is a sort of high 
level language I have developed and is 
the basis of the Editor, Mailing List, 
and Information Retrieval packages sold 
by The COMPUTERIST, as well as a large 
number of utilities we use internally 
for such operations as printing labels 
for cassette tapes, creating copies of 
program tapes, and so forth. Each of 
the Functions is, essentially, a sub- 
routine which is called and passed a 
set of parameters. If the arguments 
required are placed in the proper loca- 
tions - 00D9, DA, and DB - and if the 
instruction at location 01AB is changed 
from JMP NXTSTP to RTS, then JUSTIFY 
may be called as a simple subroutine. 

Operation of Justify 

JSTIFY uses the pointer in CMND+03 to 
pick up the full address of the buffer 
which contains the material to be just- 
ified, and stores it in BUFFER and 
BUFFER+01. 

CLEAR puts zero in each of the seven 
counters, NULLS to TEMP, and then puts 
a zero at the first location past the 
end of the buffer as defined by the 
start of the BUFFER and the length as 
defined by the parameter CMND+01. This 
zero guarantees a null for the end of 
buffer test later on. 

MORE starts at the end of the buffer 
to pick up and test each character in 
order to get a count of the number of 
nulls, spaces, and other characters. 
It also tests for a Control N (0E). A 
Control N is used to signal that No 
Justification is required on the cur- 
rent line and control branches to NEXT. 
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JUSTIFY FUNCTION - 16 JAN 1978 
JUSTIF ORG $0120 







NULLS 




$OOCC 






SPACES 


M 


$00CD 






CHARS 




$OOCE 






C0FSE1 


jf 


$OOCF 






S0FSE1 


M 


$00D0 






EXCESS 


* 


$00D1 






TEMP 




$00D2 






POINT 




$00D3 






BUFFEE 


ft 


$00D4 






MODE 




$00D6 






CMND 




$00D8 






OUTCH 




$1EA0 






NXTSTP 


ft 


$0304 


0120 A6 


DB 


JSTIFY 


LDXZ 


CMND +03 


0122 B5 


00 




LDAZX 


$00 


0124 85 D4 




STAZ 


BUFFER 


0126 B5 


01 




LDAZX $01 


0128 85 D5 




STAZ 


BUFFER +01 


012A A2 


07 




LDXIM $07 


01 2C A9 


00 




LDAIM $00 


01 2E 95 


CC 


CLEAR 


STAZX 


NULLS 


0130 CA 






DEX 




0131 10 


FB 




BPL 


CLEAR 


0133 A4 D9 




LDYZ 


CMND +01 


0135 91 


D4 




STAIY 


BUFFER 


0137 88 






DEY 




0138 B1 


D4 


MORE 


LDAIY 


BUFFER GET CHARACTER TO COUNT 


01 3A C9 


OE 




CMPIM $0E 


01 3C FO 


59 




BEQ 


NEXT NO JUSTIFICATION 


013E C9 


20 




CMPIM 


$20 TEST SPACE CHARACTER OR LESS 


0140 FO 


1E 




BEQ 


SCOUNT EQUAL SPACE 


0142 10 


1E 




BPL 


CCOUNT EQUAL CHARACTER 


0144 E6 


CC 




INCZ 


NULLS EQUAL NULL 


0146 88 




AGAIN 


DEY 


DECREMENT STRING COUNTER 


0147 10 


EF 




BPL 


MORE 


0149 C8 




TEST 


INY 




01 4A B1 


D4 




LDAIY 


BUFFER 


014C C9 


OB 




CMPIM $0B 


01 4E FO 


16 




BEQ 


CENTER 


0150 C6 


CE 




DECZ 


CHARS 


0152 A6 


CC 




LDXZ 


NULLS TEST ANY NULLS 


0154 FO 


41 




BEQ 


NEXT NO NULLS 


0156 A5 


DA 




LDAZ 


CMND +02 


0158 CA 




MULT 


DEX 


CALCULATE UNITS TO EXPAND 


0159 FO 


22 




BEQ 


DIVIDE GO TO DIVIDE 


015B 18 






CLC 




01 5C 65 DA 




ADCZ 


CMND +02 


01 5E DO 


F8 




BNE 


MULT MULT LOOP UNTIL DONE 
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0160 E6 CD 


SCOUNT 


INCZ 


SPACES 


0162 E6 CE 


CCOUNT 


INCZ 


CHARS BUMP SPACES AND CHAR COUNTERS 


0164 DO EO 




BNE 


AGAIN 


0166 E6 D3 


CENTER 


INCZ 


POINT 


0168 46 CC 




LSRZ 


NULLS 


01 6A 90 06 




BCC 


SHIFT 


01 6C A5 DA 




LDAZ 


CMND +02 


01 6E 4A 




LSRA 




01 6F 20 BE 01 




JSR 


OFFSET 


0172 A9 20 


SHIFT 


LDAIM $20 


0174 20 AO 1E 




JSR 


OUTCH 


0177 C6 CC 




DECZ 


NULLS 


0179 DO F7 




BNE 


SHIFT 


01 7B FO 1A 




BEQ 


NEXT 


01 7D C5 CE 


DIVIDE 


CMPZ 


CHARS TEST CHAR SPACING 


01 7F 30 09 




BMI 


DIVDON UNITS < CHARS 


0181 38 




SEC 


UNITS >= CHARS 


0182 E5 CE 




SBCZ 


CHARS HOW MANY UNITS PER CHAR 


0184 E6 CF 




INCZ 


COFSET BUMP COUNTERS 


0186 E6 DO 




INCZ 


SOFSET 


0188 DO F3 




BNE 


DIVIDE UNCOND. BRANCH 


01 8A C5 CD 


DIVDON 


CMPZ 


SPACES REMAINDER TO SPACES 


01 8C 30 07 




BMI 


SDONE 


01 8E 38 




SEC 




01 8F E5 CD 




SBCZ 


SPACES 


0191 E6 DO 




INCZ 


SOFSET 


0193 DO F5 




BNE 


DIVDON 


0195 85 D1 


SDONE 


STAZ 


EXCESS REMAINDER TO EXCESS 


0197 A4 D3 


NEXT 


LDYZ 


POINT GET STRING POINTER 


0199 E6 D3 




INCZ 


POINT BUMP FOR NEXT TIME 


019B B1 D4 




LDAIY 


BUFFER FETCH CHARACTER 


019D C9 18 




CMPIM 


[ $18 BOLD? 


01 9F FO 43 




BEQ 


BOLD 


01A1 C9 19 




CMPIM $19 NORMAL? 


01A3 FO 3F 




BEQ 


BOLD 


01A5 C9 20 




CMPIM $20 TEST SPACE 


01A7 FO 29 




BEQ 


SPACE 


01 A9 10 03 




BPL 


CHAR 


01 AB 4C 04 03 




JMP 


NXTSTP 


01AE 20 AO 1E 


CHAR 


JSR 


OUTCH 


01B1 C6 CE 




DECZ 


CHARS CORRECTION FOR LAST CHAR 


01B3 30 E2 




BMI 


NEXT LAST CHAR 


01B5 A5 CF 




LDAZ 


COFSET FETCH OFFSET 


01B7 FO DE 


NTEST 


BEQ 


NEXT 


01B9 20 BE 01 




JSR 


OFFSET 


01BC FO D9 




BEQ 


NEXT 


01BE AA 


0FFSE1 


' TAX 




01BF A9 10 




LDAIM $10 
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01C1 20 A0 1E 
01C4 A9 48 
01C6 20 AO 1E 
01 C9 CA 
01 CA DO F8 
01CC A9 1C 
01CE 20 AO 1E 
01D1 60 



JSR OUTCH 
BUMP LDAIM 'H 

JSR OUTCH 

DEX 

BNE BUMP 

LDAIM $1C 

JSR OUTCH 

RTS 



01D2 20 AO 1E SPACE JSR OUTCH 



01D5 A5 DO 
01D7 A6 D1 
01D9 FO 05 
01DB C6 D1 
01DD 18 
01DE 69 01 
01E0 C9 00 
01E2 10 D3 

01E4 18 
01E5 69 1E 
01E7 AA 
01E8 A9 1B 
01EA 20 AO 1E 
01 ED 8A 
01EE 20 AO 1E 
01F1 DO A4 



LDAZ 
LDXZ 
BEQ 
DECZ 
CLC 
ADCIM $01 
NOXCES CMPIM $00 
BPL 



SOFSET FETCH SPACE OFFSET 

EXCESS TEST EXTRA OUTPUT 

NOXCES 

EXCESS DECREMENT EXCESS 



NTEST 



BOLD CLC 



ADCIM $1E 

TAX 

LDAIM $1B 

JSR OUTCH 

TXA 

JSR OUTCH 

BNE NEXT 



INCREMENT OFFSET 



TEST first checks to see if the Center 
Mode ha; i been specified by the Control 
K (OB) character. It then checks to 
determine if there are any nulls at the 
end of the line. If there are no nulls 
then the line can be printed with no 
further justification required. It is 
already justified. 

MULT multiplies the number of nulls by 
the character width provided by param- 
eter CMND+02. This gives the number of 
units that must be distributed through- 
out the line to provide left and right 
justification. 

CENTER handles the Center Mode of 
justification. It bumps over the Con- 
trol K character and divides the nulls 
by two so that the nulls will be evenly 
divided. It tests for an odd or even 
number of nulls using a BCC after the 
LSRZ which does the divide. If there 
are an even number of nulls, then it 
branches to SHIFT. IF there are an odd 
number of nulls, it picks up the char- 
acter width from CMND+2, divides this 
two to get a one-half character offset 
to provide more accurate centering. 
This is output via the OFFSET routine. 



SHIFT moves the printer to the start of 
the centered line by outputting spaces 
equal to one-half the original number 
nulls. When finished it branches to 
NEXT which takes care of printing the 
text. 

DIVIDE allocates the excess units along 
the line of text to produce the Full 
Justification. It first tests to see 
if it can allocate an additional unit 
to each individual character and space. 
If so, it increments both the character 
offset counter (COFSET) and the space 
offset counter (SOFSET). It then tests 
whether another unit can be allocated, 
until it finds that there are fewer 
units to be allocated than characters 
and spaces. 

DIVDON takes care of any units remain- 
ing after the DIVIDE allocation. These 
are divided among the spaces, incre- 
menting SOFSET until there are fewer 
units than spaces. The remainder, if 
any, is stored in EXCESS where it will 
be used on spaces starting at the be- 
ginning of the line. 
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NEXT handles the printing. It picks up 
and examines the next character. It 
branches to BOLD, SPACE, CHAR, or re- 
turns to the calling program if a null 
is encountered . 

CHAR outputs the character using the 
system subroutine , in this case the KIM 
OUTCH subroutine. It tests for last 
character and puts out the character 
offset (COFSET) if non-zero. 

OFFSET saves the offset in X, then puts 
the Diablo printer into PLOT mode by 
outputting a 10 hex. It then puts out 
one 'H' for each unit of offset, and 
finally returns the printer to TEXT 
mode by printing a 1C hex. 

SPACE outputs a space, then combines a 
unit of EXCESS with the space offset 
and goes to NTEST to output the offset 
if not zero . 

BOLD converts a Control X to '6' or a 
Control Y to '7 1 , and then outputs the 
character after issuing an escape 1B 
hex. This sets or clears the print 
enhancement mode . 

The DIRECT TYPESETTER 

One use of JUSTIFY has been in a HELP 
program for direct typesetting. In 
this program a sheet of paper is in- 
serted sideways in the terminal . Mate- 



rial is entered and edited on the left 
side of the page and typeset on the 
right side . 

The CPRINT Function outputs a Control 
Comma (CTLCMA) 1C hex which sets the 
printer in TEST mode , and then issues a 
Carriage Return (CR) 0D hex. 

The INPUT Function accepts data from 
the terminal , places it in the buffer 
defined by FILE (starts at 1780 and is 
39 decimal characters long) , and sup- 
ports some editing features . 

The next CPRINT causes the printer to 
TAB to the right side of the page , to 
the left margin of the typesetting 
area. 

JUSTFY does the actual justification 
and printing. Its parameters specify 
that the set line has a maximum width 
of 39 decimal characters; that the 
width of each character is 10 units; 
and the 1E is a pointer to the start of 
the buffer - FFILE. 

The last CPRINT sets the printer back 
one horizontal unit to provide a closer 
line spacing. 

The BRANCH simply returns control to 
NEXT and the system is ready for the 
next line to be input . 



DIRECT TYPESETTER - 16 Jan 1978 



0004 


0B1C010D 


1 


NEXT 


CPRINT 


CTLCMA 


1 CR 


0008 


081C0080 


2 




INPUT 


FILE 


80 


000c 


0B090100 


3 




CPRINT 


TAB 


1 


0010 


01270A1E 


4 




JUSTFY 


39. 


10. 1E 


0014 


0B10014E 


5 




CPRINT 


CTLP 


1 "N 


0018 


03010000 


6 




BRANCH 


NEXT 




001C 


20008017 


7 


FILE 


FMAP 




FFILE 


0020 


00270000 


8 


FMAP 


00. 


39. 





TEXT MODE, CARRIAGE RETURN 

CLEAR AND INPUT TEXT 

TAB TO TYPESET AREA 

39 CHAR WIDTH, 10 UNITS PER CHAR 

PLOT MODE, UP ONE UNIT 

READY FOR NEXT LINE 

BUFFER AT 1780 

FIELD STARTS OFFSET 0, 39. CHAR. 
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TERMINAL INTERFACE MONITOR (TIM) 
FOR THE 6502 MICROPROCESSOR FAMILY 

Oliver Holt 

Old Nashua Road 

Amherst, HN 03C31 



TIM is a unique monitor program for the 6500 
microprocessor family. TIM is the forerunner to 
KIM and is still used today in many configura- 
tions — ready made and homebrew. TIM is supplied 
by MOS Technology on a MCS6530 multi-function 
chip. This chip contains ROM, RAM, an interval 
timer, and I/O. Using this chip, MOS Technology 
was able to squeeze the complete monitor func- 
tion into a single IC. The 1K of ROM in the 
6530 contains the monitor program; the 64 bytes 
of RAM are used for storage and vector interrupt 
addresses; the timer is used for timing the ser- 
ial I/O; the 13 I/O lines are used to communi- 
cate with a serial I/O device and a parallel de- 
vice. The TIM part number is MCS6530-004. 

TIM has a couple of unique features not incor- 
porated in most monitors. The first feature is 
the ability to reconfigure the TIM memory loca- 
tions during resets. During reset all I/O lines 
on the 6530 are set up as inputs and look like 
high signals to external devices. One of these 
I/O lines is used with address line A15 to make 
A15 a "don't care" condition. 6500 type micro- 
processors fetch the reset vector address from 
FFFC and FFFD. Because A15 is a "don't care", 
the vector address is fetched from 7FFD instead 
of FFFC and FFFD. Locations 7FFC and 7FFD con- 
tain the TIM entry point for a reset condi- 
tion. 

Figure 1 is a block diagram of a minimum TIM- 
based system including the circuitry required to 
accomplish the reset operation. The 1/0 line 
used is PB4. This signal is inverted and NANDed 
with A15. During reset PB4 is high making PBl 
low. A low input to the NAND gate causes a high 
output, always enabling CS1 on the 6530. When 
the I/O) ports are initialized in the reset ser- 
vice routine, PB4 goes low making PB4 a high. 
Now the output of the NAND gate is KT5 and CS1 
is only high when A15 is low. CS1 along with 
the other chip selects and the address lines 
give the 6530 a set of unique addresses below 
8000 but the software is set up for the address 
space between 7000 and 73 FF. 

The other unique feature of the TIM is that the 
terminal interface speed is adaptive. After the 
system is reset , the user types a carriage ret- 
urn. TIM measures the terminal speed using the 
data stream generated by the carriage return 
signal . This speed information is stored and 
and used as the terminal speed for all following 
communication with the external device until the 
next time the system is reset . 

After the reset and carriage return , TIM res- 
ponds with an "»" and prints the contents of the 
registers, followed by an automatic carriage 
return and a ".". The period indicates that TIM 
is now ready to accept user commands. TIM com- 
mands allow displaying registers, executing pro- 
grams, examining and altering memory, reading 
hexadecimal data from either a high speed reader 
or a TTY and writing either hexadecimal or BNPF 
data to a TTY. (BNPF is a tape format used by 
some of the older PROM programmers) . 

Using the BRK instruction the user can set up 
breakpoints to monitor the execution of a pro- 
gram. The user inserts a BRK instruction (00) 
where the breakpoints are required. Upon execu- 



tion of BRK instruction TIM is entered and the 
registers are printed. The vector address for 
a BRK instruction is stored in RAM at FFFE and 
FFFF. The user may alter these locations and 
write his own routine for handling debug operat- 
ions . 

All TIM operations are performed in hex unless 
a BNPF tape is required. The memory is display- 
ed in hex in groups of eight memory locations as 
shown: 



.M 0000 00 0J 02 03 04 05 06 ,07 



command 




data 



TIM will respond with a period "." after each 
command is completed . If a user wants to modify 
data , he first opens memory with the "M" command 
and then types a colon ":" as follows: (Under- 
lined data is what the user types) . 

.M. 0000 00 01 02 03 04 05 06 07 

• 1 0000 00 01 25 03. 99 ( carriage return) 

The carriage return terminates the operation. 
The 6500 registers may be examined: 

.R 7052 31 27 F0 01 FF 
PC P A X Y SP 

After the registers have been opened for examin- 
ation, they may be changed using the colon ":" 
as shown: 

.£. 7052 31 27 F0 01 FF 

•l 0100 00 00 00 00 FF ( carriage return ) 

The other commands for reading and punching 
tapes operate in a similar manner. TIM also has 
a switch which is set by the "H" command that 
specifies whether or not a high speed reader or 
TTY is the source of paper tape input. 

TIM, like KIM, also has many useful subroutines 
that can be called by a users program. A set of 
useable subroutines to type characters, read 
characters, type a line feed and carriage ret- 
urn , type a space , and to type a byte in hex are 
completely documented in the TIM manual. There 
are other subroutines that can be used that are 
not documented and these include double precis- 
ion addition , output a bit , input a bit , ASCII 
conversion , and input eight bits . 

The TIM manual contains a complete software 
listing and a memory test program. The manual 
also includes example programs to aid the user 
in becoming familiar with the TIM commands. TIM 
is a very useful building block for anyone in- 
terested in building their own 6500 system. It 
has been used as the monitor for a number of 
systems available in kit and/or assembled ver- 
sions. These include the CGRS Microtech 6000 
system, the DATAC 1000, and others. 

If you are interested in building your own home- 
brew system, Figure 1 is a block diagram for a 
basic system. TIM is available from MOS Tech- 
nology representatives . 
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TIM MEETS THE S100 BUS 



Gary L. Tater 

7925 Nottingham Way 

Ellicott City, MD 21043 



Hardly a computer meeting goes by with- 
out a discussion of which bus structure 
is best. While the S100 bus may not be 
optimum for the 6502 microprocessor, 
its use does make purchasing RAM and 
ROM boards easy. 

With this in mind, I purchased a 6502 
CPU board for the S100 bus from CGRS 
Microtech. This CPU board is almost a 
complete system with its onboard 2K RAM 
and 4K ROM. But in order to use my 
CT-64 Southwest Technical Products 
video terminal with this CPU, I needed 
an S100 terminal interface monitor 
(TIM) board. While CGRS markets a very 
nice TIM board, I elected to build a 
bare bones S100 TIM board which is des- 
cribed in this article. 

In addition to serving as a serial I/O 
port for a terminal , TIM contains an 
operating system for 6500 microcompu- 
ters. The 0CT-N0V issue of MICRO (page 
5) contains an article on the opera- 
tion of the TIM program. In summary, 
TIM is a read-only memory and 1/0 de- 
vice that is self adapting to terminal 
speeds between 10-30 cps. With TIM 
you can display and alter CPU and mem- 
ory location using a keyboard and video 
display; you can read and write hex 
formatted data from a paper tape or a 
cassette interface such as the South- 
west Technical Products AC-30; and you 
have an eight bit parallel I/O port 
where each bit of the eight can be pro- 
grammed as either input or output. 

As you can see from the schematic dia- 
gram (Figure 2), only the TIM chip 
(6530-004) and four integrated circuits 
are needed, excluding voltage regula- 
tors. For the perfectionist, buffering 
could be added to the address lines, 
data lines, and parallel output port, 
but two CGRS Microtech systems are now 
successfully using this TIM design. 
Integrated circuits U2 and U3 are used 
during resets to reconfigure TIM memory 
locations as described in the previous- 
ly referenced TIM article. The MC 1488 
and MC 1489 are Motorola devices which 
convert TTL levels to RS 232 levels and 
RS 232 levels to TTL respectively. 



A memory map of this TIM design is pro- 
vided in Figure 1 . For proper opera- 
tion of a 6502 microprocessor and this 
TIM board, you will need both page zero 
and page one memory. Page one is need- 
ed by the 6502 microprocessor for its 
software stack. Page zero memory is 
used in the TIM program to store the 
baud rate of your terminal (locations 
00EA and 00EB) . 

To operate a TIM based system you need 
only momentarily ground pin 16 of TIM 
(pin #75 of the S100 bus) using a 
switch on your front panel. After you 
send a carriage return to the computer, 
you should see a TIM message such as: 

7052 30 2E FF 01 FF 

This message contains first the program 
counter (7052), processor status regis- 
ter (30), accumulator (2E), X register 
(FF) , Y register (01), and stack point- 
er (FF) . The actual values will vary 
from machine to machine. 



7000 - 


- 73FF TIM ROM 


FFC0 ■ 


- FFFF TIM RAM 


6E00 - 


- 6E0F TIM 1/0 


6E02 


Serial Port 



Figure 1 
TIM Board Memory Map 



If you have a problem, first check all 
of your wiring and the +5, +12, and -12 
voltages. Then insure that your reset 
switch is controlling pin 16 of TIM. 
Next, using an oscilloscope, check for 
a carriage return character at pin 25 
of TIM and pin 24 for the TIM message. 
With a good signal at pin 25 but no an- 
swer at pin 24, the last two things to 
check are the address lines including 
pin 21, PB4, and finally, check your 
TIM chip in a working system. The two 
systems built using this design on pro- 
totype boards came up immediately. 
Hopefully, you will have the same good 
fortune . 
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Figure 2. 
S100 TIM Board 
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THE CHALLENGE OE THE OSI CHALLENGER 



Joel Henkel 

Old County Road 

Hillsborough, NH 03244 



One of the factors that a purchaser of a micro- 
computer system must consider is the degree of 
"do it yourself" hardware and software effort he 
will have to exert to get his system doing what 
he wants. This effort, not evident from manu- 
facturers' literature, can be critical for user 
satisfaction, as became evident in our experience 
with the OSI Challenger. These notes evaluating 
the Challenger may be helpful to prospective 
purchasers. 

In any hobby industry, user skills are assumed. 
This is emphasized for microcomputer firms that 
formerly catered to electronic kit builders. OSI 
is one of these, having supplied special PC board 
kits to hams. They follow their own packaging 
philosophy that differs from the "standard" 
S-100 bus configuration. Their brochure ex- 
plains that the 100 pin S-100 connectors were 
rejected because the fingers were subject to poor 
contact. Instead, OSI uses MOLEX connectors, 
which make positive contact. The brochure goes 
on to describe the rejection of on-board voltage 
regulators in favor of a self contained regulated 
power supply. 

OSI circuit boards are larger than standard S-100 
bus boards. This accommodates their design 
philosophy of packing many optional functions 
into one foil pattern. For example, their 430B I/O 
board supports: an eight channel multiplexed 
eight bit analog to digital converter, two chan- 
nels of eight bit digital to analog conversion and 
a UART controlled cassette I/O interface or an 
RS232/twenty mil loop I/O interface. 

Our system came without keyboard or video 
monitor. Interfacing for these is left to the user. 
The computer cabinet has two holes in its rear 
panel for user implemented I/O cabling from 
individual boards. The keyboard DIP socket and 
video output RCA connector are available at the 
edge of the 440 video board. MOLEX connectors 
on the edge of the 430 board provides access to 
the various I/O options. 

Hardware documentation consists of kit con- 
struction manuals for individual boards, even if 
the boards are purchased assembled. Various 
options are treated separately. Overall hardware 
system documentation is completely lacking. 



For example, nowhere is there a description of 
the bus convention and pinout. One must gen- 
erate these from actual inspection of board foil 
patterns. This exercise reveals interesting peculi- 
arities, such as bringing the NMI (non-maskable 
interrupt line) and IRQ (interrupt request line) 
onto many boards and leaving them unconnected. 

The software is sophisticated. One enters the 
system by resetting. A prompter, D/M, comes up 
on the video screen. To enter the video monitor, 
styled after the KIM, enter M and the six hex 
digits appear near the top of the screen. For 
DOS (disc operating system), enter D and the 
DOS is brought up through BASIC by a boot- 
strap ROM. (Earlier versions required loading a 
short sequence of memory locations using the 
video monitor.) From BASIC one can enter the 
DOS, from which it is possible to go to various 
modules, such as an extended monitor, back to 
BASIC, or to activate a few DOS commands, 
such as loading and recalling disc files, executing 
programs, or switching floppy disc drives (for 
dual floppy discs). The EXTENDED BASIC by 
MICROSOFT has many advanced features, such 
as string functions, and is apparently much 
faster than a comparable 8080 BASIC. 

Software documentation is poorly organized. 
Perhaps with so many possible options, the job 
of creating well organized system documenta- 
tion was beyond OSFs capability. Our experience 
with software documentation availability was 
sobering. The system comes with all OSI soft- 
ware on discette. However, only a BASIC users 
manual is included, beyond a general system 
description. One has to order software user 
manuals separately. We waited a long five 
months after order for ours. 

We have used two versions of the DOS, an ori- 
ginal 1.1 version and an updated 2.0 version. 
One interesting change has to do with copying 
the DOS itself. The original version could not be 
copied and an explicit notice to that effect was 
included. An unfortunate set of circumstances 
could come about, however, that would wipe 
out track one, completely disabling any further 
loads of the DOS. If computer power fails (or 
one turns off the computer) with the disc in its 
drive, out goes track one! Apparently a number 
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of users had this happen (including us). Version 
2.0 has complete copying capability. According 
to instructions the first thing one should do is 
copy the DOS and store away one copy in case 
of wipeout. 

Another change from the original version is the 
serial display output rate to the video monitor, 
which was increased from ten characters per 
second to several times that rate. A third change 
in the DOS is an augmented facility to read and 
write disc files. 

The 440 board video display format chosen is 
twenty four characters per line, which is too 
small. One can only speculate on the reason for 
the short line. 

Many applications could readily use a real time 
operating system, (RTOS). OSI does not offer a 



RTOS, but has advertised that one, modelled on 
DEC's RTS11 is in the works. When contacted 
recently, however, OSI reported that it has in- 
definitely postponed development of its RTOS 
in favor of development of a business system. 
The contemplated RTOS may explain the inter- 
rupt lines found in the foil patterns of several 
boards mentioned earlier, and a foil pattern 
option on the 470 floppy disc controller board, 
a real time clock in the form of a divider chain 
driven by the on-board crystal clock. 

In summary, the OSI Challenger offers a lot of 
computer for the money. The tradeoff is the 
board orientation rather than system orienta- 
tion, requiring a larger than average effort on 
the part of the user to bring his system up. This 
effort includes I/O interface cabling and "reading 
between the lines" in the supporting documenta- 
tion. 



MICRO Reviews: The First Book of KIM 

This is one terrific book for anyone who has a KIM-1. It was assembled by Eric 
Rehnke (Publisher of "KIM-1/6502 User Notes"), Jim Butterfield ("Hypertape" and 
many other good utilities), and Stan Ockers (a regular "User Notes" contributor). 
Over half of the book is devoted to "Recreational Programs", games you can play 
on your basic KIM-1. The section on "Diagnostic & Utility Programs" is worth 
the price of the book by itself. The remainder of the book contains tutorial 
information on getting started with your KIM-1 , expanding your system, and inter- 
facing to the outside world. This well produced, 176 page resource is now 
published by Hayden Book Company and available at your computer book store 
for $9-00. 
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ROCKWELL'S NEW K6500/1 

Rockwell International 

Electronic Devices Division 

3310 Miraloma Avenue 

P.O. Box 3669 

Anaheim, CA 92803 



ANAHEIM, CA., May 11, 1978 — A single- 
chip NMOS microcomputer (R6500/1) oper- 
ating at 2 MHz with a 1 microsecond 
minimum instruction execution time, has 
been developed by Rockwell Int'l. 

The 40-pin R6500/1 is fully software 
compatible with the 6500 family. It 
has the identical instruction set, in- 
cluding the 13 addressing modes, of the 
6502 CPU. It operates from a single 5V 
power supply, and features a separate 
power pin which allows RAM memory to 
function on "\0% of the operating Dower. 
On-chip features include 2K x 8 ROM, 64 
x 8 RAM, 1 6-bit interval timer/event 
counter, and 32 bidirectional I/O 
lines. Additionally, it has maskable 
and non-maskable interrupts and an 
event-in/timer-out line. 

The 32 bidirectional I/O lines are di- 
vided into four eight-bit ports (A, B, 
C and D) . Each line can be selective- 
ly used as an input or an output . Two 
inputs to Port A can be used as edge 
sensing, software maskable, interrupt 
inputs -- one senses a rising edge; 
the other a falling edge. 



Four different counter modes of oper- 
ation are programmable: (1) free run- 
ning with clock cycles counted for real 
time reference; (2) free running with 
output signal toggled by each counter 
overflow; (3) external event counter; 
and (4) pulse width measurement mode. 
A 16-bit latch automatically reinitial- 
izes the counter to a preset value. 
Interrupt on overflow is software mask- 
able. 



A 64-pin Emulator part, of which 40 
pins are electrically identical to the 
standard R6500/1 part and which comes 
in either 1 MHz or 2 MHz versions, is 
available now. Rockwell expects to be- 
gin receiving codes from customers in 
July for production deliveries in Sept. 
Quantity prices for 6500/1 production 
devices are under $10.00 for both the 

1 MHz and 2 MHz models. Single-unit 
prices for Emulator parts are $75.00 
for the 1 MHz model and $95.00 for the 

2 MHz version. 

Contact: Leo Scanlon - 714/632-2321 
Pattie Atteberry - 213/386-8600 
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ROCKMfELL'S AIM IS PRETTY GOOD 



Rockwell International 

Microelectronic Devices 

P.O.Box 3669 

Anaheim, CA 92803 

714/632-3729 



Rockwell's AIM 65 (Advanced Interface 
Module) gives you an assembled , versa- 
tile microcomputer system with a full- 
size keyboard, 20-character display and 
a 20-character thermal printer! 

AIM 65' s terminal-style ASCII keyboard 
has 54 keys providing 69 different 
alphabetic , numeric and special func- 
tions. 

AIM 65' s 20-character true Alphanumeric 
Display uses 16-segment font monolithic 
characters that are both unambiguous 
and easily readable. 

AIM 65 's 20-column Thermal Printer 
prints on low-cost heat sensitive roll 
paper at a fast 90 lines per minute. 
It produces all the standard 64 ASCII 
characters with a crisp-printing five- 
by-seven dot matrix. AIM 65' s on-board 
printer is a unique feature for a low 
cost computer. 

The CPU is the R6502 operating a 1 MHz. 
The basic system comes with 1K RAM, ex- 
pandable on-baord to 4K. It includes 
a 4K ROM Monitor , and can be expanded 
on-board to 16K using 2332 ROMs or can 
also accept 2716 EPROMs. An R6532 RAM- 
Input/Output-Timer is used to support 
AIM 65 functions. There are also two 
R6522 Versatile Interface Adaptors. 
Each VIA has two 8-bit, bidirectional 
TTL ports, two 2-bit peripheral hand- 
shake control ports and two fully pro- 
grammable interval timer/counters. 






The built-in expansion capability in- 
cludes a 44-pin Application Connector 
for peripheral add-ons and a 44-pin Ex- 
pansion Connector with the full system 
bus. And, both connectors are totally 
KIM-1 compatible! 

TTY and Audio Cassette Interfaces are 
part of the basic system. There is a 
20 ma current loop TTY interface, just 
like the KIM-1 , and an Audio Cassette 
Interface which has a KIM-1 compatible 
format as well as its own special 
binary blocked file assembler compat- 
ible format. 

The DEBUG/MONITOR includes a mini-as- 
sembler and a text editor. Editing may 
use the keyboard, TTY, cassette, print- 
er and display. The Monitor includes a 
typical set of memory display/modify 
commands. It also has peripheral de- 
vice controllers, breakpoint capability 
and single step/trace modes of debug- 
ging. An 8K BASIC Interpreter will be 
available in ROM as an option. 




AIM 65 will be available in August, 
will cost $375. 
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SYNERTEK 'S VIM-1 

Synertek Incorporated 

P.O. Box 552 
Santa Clara, CA 95052 



Synertek has announced a new 6502-based 
microcomputer system with the following 
features: 

FULLY-ASSEMBLED AND COMPLETELY INTE- 
GRATED SYSTEM that's ready-to use as 
soon as you open the box. 

28 DOUBLE-FUNCTION KEYPAD INCLUDING UP 
TO 24 "SPECIAL" FUNCTIONS. 



IK BYTES OF 2114 STATIC RAM on-board 
with sockets provided for immediate ex- 
pansion to 4K bytes on-board, with to- 
tal memory expansion to 65,536 bytes. 

USER PROM/ROM: The system is equipped 
with 3 PROM/ROM expansion sockets for 
2316/2332 ROMs or 2716 EPROMs. 



EASY-TO-VIEW 6-DIGIT HEX LED DISPLAY. 

KIM-1 HARDWARE COMPATIBILITY. 

The powerful 6502 8-bit MICROPROCESSOR 
whose advanced architectural features 
have made it one of the largest selling 
"micros" on the market today. 

THREE ON-BOARD PROGRAMMABLE INTERVAL 
TIMERS available to the user for timing 
loops, watchdog functions, and real- 
ime communication protocols. 

4K BYTE ROM RESIDENT MONITOR and Oper- 
ating Programs. 

Single 5 Volt power capability is all 
that is required. 



ENHANCED SOFTWARE with simplified user 
interface. 

STANDARD INTERFACES INCLUDE: 

- Audio Cassette Recorder Interface 
with Remote Control (Two modes: 135 
Baud KIM-1 compatible, Hi-speed 2400 
Baud). 

- Full Duplex 20mA Teletype Interface 

- System Expansion Bus Interface 

- TV Controller Board Interface 

- CRT Compatible Interface 

APPLICATION PORT: 15 Bi-directional TTL 
lines for user applications with expan- 
sion capability for added lines. 

EXPANSION PORT FOR ADD-ON MODULES (50 
1/0 Lines in the basic system). 
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THE MICRO SOFTWARE CATALOG 

Mike Rowe 

P.O. Box 3 

S. Chelmsford, MA 01824 



As a service to the 6502 community, 
MICRO will publish a continuing cata- 
log of software available for 6502 
based systems. The source of this in- 
formation will normally be the authors 
or distributors of the software. Since 
there is only a limited amount of space 
which can be devoted to this effort, 
there will be some restrictions placed 
on what is published. To qualify for 
inclusion in the catalog the software 
must be currently available, should 
have been sold (or given) to at least 
twenty- five customers, must be of gen- 
eral interest, and must be significant. 
"Significant" means that the program is 
not just a short utility which could be 
presented as a one-page 'article in a 
magazine, or a simple game, etc. The 
intent of the catalog is not to promote 
everyone selling everything, but rather 
to highlight the important software 
packages which do exist . 



Publication of information about any 
software in this catalog does not imply 
anything about its worth, capabilities, 
documentation , etc . We depend on the 
information supplied to us. We will 
not knowingly include any software that 
is not worthy, and we reserve the right 
to publish additional information about 
these products - be it good or bad - 
that we receive from our readers or any 
other valid source. 

It is easy to get your package listed. 
Just write to the above address and 
provide the information required as 
shown in the listings below. Please 
write your own "description" . If we 
have to write the description from gen- 
eral information you provide, we may 
miss points which you think are import- 
ant and emphasize things you think are 
trivial. Also, material which is pre- 
sented in the proper form will normally 
get priority over other material . 



Name : ASSM/TED 

System: Preconfigured for TIM 

Can be modified for other systems. 
Memory: 4K RAM 
Language : Assembler 
Hardware: CRT and Keyboard, tapes and 

printer optional . 
Description: A resident Assembler/Text 
Editor. Syntax very similar to MOS 
Technology. Produces relocatable ob- 
ject code on tape and can store direct- 
ly executable code in memory during as- 
sembly. Programs can be assembled from 
memory of tape. Includes 17 operating 
commands and 16 pseudo ops. Editor has 
auto line numbering, file formating, 
and a manuscript feature. 
Copies: Information not provided. 
Price: $25.00 

Includes: Hex Dump of ASSM/TED and Re- 
locating Loader, and Operators Man- 
ual. No tape provided. 
Ordering Info: Specify memory limits: 

0200-1200, 0400-1400, 1000-2000, or 

2000-3000. Select one. 
Author: C. W. Moser 
Available from: 

C. W. Moser 

3239 Linda Drive 

Winston-Salem, NC 27106 



Name: COSMAC 1802 Simulator 
System: KIM-1 
Memory: Less than 1K RAM 
Language : Assembler 
Hardware: Basic KIM-1 
Description: Permits the KIM-1 to sim- 
ulate the COSMAC 1802 by executing its 
instruction set. The simulator does 
this by interpretting the COSMAC in- 
structions in a normal program sequence 
and making all internal COSMAC regis- 
ters available for examination at any 
time. They may be viewed statically in 
a single step mode or dynamically in a 
trace mode. All COSMAC software fea- 
tures are supported with the exception 
of DMA. 

Copies: Just released. Will be dis- 
cussed in an article in Kilobaud. 
Price: $10.00 
Includes: KIM-1 cassette tape, user 

manual, and complete source listing. 
Ordering Info: None required 
Author: Dann McCreary 
Available from: 
Dann McCreary 
4758 Mansfield St, #2M 
San Diego, CA 92116 
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Name : PLEASE 
System: Basic KIM-1 
Memory: Basic KIM-1 memory 
Language : Assembler/PLEASE 
Hardware: Basic KIM-1 
Description: A collection of games and 
demos. Includes a 24 hour clock, HiLo 
game, Mastermind, Shooting Stars, Drunk 
Test, Reaction Time Tester, Adding Ma- 
chine, and more. Written in a "high- 
level" language - PLEASE. Permits the 
user to modify and create his own pro- 
grams. Let's you show off your KIM-1, 
and teaches you how to use it. 
Copies: Over 800 have been sold 
Price: $15.00 

Includes: Operators manual, complete 
source listings, PLEASE language de- 
scription, with object code on Hyper- 
tape. 

Ordering Info: None 
Author: Robert M. Tripp 
Available from: 

The COMPUTERIST 

P.O. Box 3 

S. Chelmsford, MA 01824 



Name: The 6502 Program Exchange 
System: TIM and KIM-1 
Memory: Depends on Program 
Language: Assmebler, BASIC, FOCAL 
Hardware: Depends on Program 
Description: A large collection of 
programs for 6502 based systems. These 
include utilities, games, subroutines, 
an assembler, editor, and a high level 
language: FOCAL. 
Copies: Few to Many depending on the 

particular program. 
Price: Depends on program. Many are 

based purely on number of pages of 

code . Major packages are priced 

separately. 
Includes: Normally includes source 

listings, documentation, sheets of 

sample run, and paper tape. KIM-1 

cassettes at no additional charge if 

user supplies cassettes. 
Ordering Info: Write for catalog. 
Author: Many different authors. 
Available from: 

The 6502 Program Exchange 

2920 Moana 

Reno, NV 89509 



Name : Micro- ADE 

System: KIM-1 (easily modified for use 

with other 6502 based systems) 
Memory: 8K RAM or 4K EPR0M + 4K RAM 
Language : Assembler 

Hardware: Terminal - CRT or TTY, cas- 
sette units optional 
Description: A combination Assembler, 
Editor, and Disassembler. Uses MICRO 
6502 syntax. With automatic cassette 
controls, any length file may be edited 
and assembled. Object files may be 
automatically dumped to cassette and 
for short programs may be dumped to and 
executed from memory. Includes many 
useful commands for handling cassettes, 
moving data in memory, and so forth. 
Copies : Hundreds 

Price: $25.00 without source listings 
$25.00 for source listings 
Includes: Extensive user manual which 

includes source listings for the 1/0 

to permit user modification. Object 

on Hypertape cassette. 
Ordering Info: Specify with or without 

the optional source listings. 
Author: Peter Jennings 
Available from: 

Micro-Ware Ltd . 

27 Firstbrooke Road 

Toronto, Ontario 

Canada M4E 2L2 



Name: Personal Savings Investment 
Loan Repayment 
Direct Reduction Loan Info . 
System: APPLE II 
Memory: At least 16K 
Language: APPLESOFT BASIC 
Hardware: Standard APPLE II 
Description: Three separate programs. 
PSI - compute future value of your in- 
vestments; monthly amount needed to get 
to a certain goal at a certain time. 
LP - determine monthly payments for a 
car, house or other type of load. 
DRLI - find the total interest paid and 
remaining balance is for a loan. 
Copies : Over 25 combined 
Price: $3-75 (including handling) each 

of the three programs. 
Includes: Object on cassette tape. A 

listing of the program and examples 

of program useage. 
Ordering Info: Specify which program. 
Author: Les Stubbs 
Available from: 

Les Stubbs 

23725 Oakheath Place 

Harbor City, CA 90710 
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Name: TINY BASIC 
System: KIM, TIM, Jolt, Apple I 
Memory: Minimum of 3K 
Language: Assembler 
Hardware: User defines I/O 
Description: TINY BASIC is a subset of 
regular BASIC, limited to 1 6-bit inte- 
ger arithmetic [+, -, *, /, ()]. There 
are 26 variables (A-Z), no stirngs and 
no arrays. The following commands are 
functional: LET PRINT INPUT IF-THEN 
GOTO GOSUB RUN LIST CLEAR RETURN 
REM END. TINY BASIC does not contain 
any I/O instructions; three JMPs link 
TINY to the user's I/O routines. These 
are well documented in the manual . 
Copies: "Several hundred 6502 version" 
Price: $5.00 
Includes: 26 page User Manual and a 

paper tape in standard hex loader 

format. Hex Dump may be substituted 

upon request for paper tape. 
Ordering Info: Specify version: 

TB650K (0200-OAFF) KIM, TIM 

TB650J (1000-l8ff) Jolt 

TB650T (2000-28FF) KIM with 4K RAM 
Author: Tom Pittman 
Available from: 

ITTY BITTY COMPUTERS 

P.O. Box 23189 

San Jose, CA 95153 



Name: HELP Mailing List Package 
System: Basic KIM-1 
Memory: Basic KIM-1 
Language : Assembler/ HELP 
Hardware: Terminal, Cassettes, Relays 
Description: A complete package for 
creating, maintaining, and printing 
mailing list information. A high speed 
cassette routine reads/writes at 800 
baud (twelve times the KIM-1 rate) and 
can store about 900 names on one side 
of a 60 minute tape. Selective print- 
ing of mailing list. This package is 
used to maintain the MICRO mailing list 
This package is written in HELP, a 
"high-level" language which makes it 
easy to customize the package for your 
own requirements. 
Copies: Over 100 
Price: $15.00 

Includes: An extensive user manual, a 
detailed discussion of the HELP 
language , and complete source 
listings. Object on Hypertape. 
Ordering Info: None 
Author: Robert M. Tripp 
Available from: 
The C0MPUTERIST 
P.O. Box 3 
S. Chelmsford, MA 01824 



Name: ASM/ TED 

System: KIM-1 (may be modified for use 

with other 6502 based systems) 
Memory: 6K RAM 
Language : Assembler 
Hardware : TTY 

Description: The text editor performs 
line editing in RAM and can dump/load 
to paper tape or audio cassette. The 
resident assembler is single-pass using 
the standard M0S Technology syntax. 
Source code may be paper tape or memory 
resident and object code is always 
to memory. 

Copies: Information not provided. 
Price: $70.00 

Includes: 50 page manual, source list- 
ings, and object on KIM cassette or 

paper tape. 
Ordering Info: Send $2.00 for current 

catalog of available software. 
Author: Not specified 
Available from: 

ARESCO 

450 Forest Ave., Q-203 

Norristown, PA 19401 



Name : MicroChess 

System: Basic KIM-1 

Memory: Basic KIM-1 

Language : Assembler 

Hardware: Basic KIM-1 

Description: Plays a reasonably good 

game of chess on a basic KIM-1 . Has 

programmed openings. User enters his 

move via the KIM keypad and the KIM 

Display shows the move. The computer 

then makes its move and displays it. 

Program may be set to play at different 

speeds: 3, 10, or 100 seconds per move 

average. A great way to demo your KIM. 

Copies : Hundreds 

Price: $10.00 without cassette 

$15.00 with cassette 
Includes: Operator's manual, source 

listings, and a detailed discussion 

of the operation of the program. 

Object on cassette tape optional. 
Ordering Info: Specify tape or not. 
Author: Peter Jennings 
Available from: 

Micro-Ware Ltd. 

27 Firstbrooke Road 

Toronto, Ontario 

Canada, M4E 2L2 
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THE MICRO SOFTWARE CATALfDG: II 

Mike Rowe 

P.O. Box 3 

S. Chelmsford, MA 01024 



Name: ZZYP-PAX for PET, #1,2, and 3 
System: PET 
Memory: 8K RAM 
Language : BASIC 
Hardware: Standard PET 
description: Each of these three ZZYP- 
for PET includes a cassette with two 
games and a booklet designed to educate 
the beginning or intermediate level PET 
programmer. #1 has IRON PLANET (Rescue 
the Princess) and HANGMAN (Guess the 
secret word). Included is a 12 page 
booklet which not only contains game 
rules, but has 5 pages of useful pro- 
gramming techniques including: Direct 
Screen Access Graphics, Flashing Mess- 
ages, and Programmed Delays. #2 con- 
tains BLACK BART (a mean-mouthed poker 
player) and BLACK BRET (for blackjack - 
one or two players). #3 contains BLOCK 
and FOOTBALL both of which allow either 
two-player or play-the-PET options. 
Copies: Just released, 40 copies. 
Price: $9-95 each 

Includes: PET tape cassette, instruc- 
tions and educational manual with info 
for program modifications. 
Ordering Info: Specify ZZYP-PAX number 
Author: Terry Dossey 
Available from: 

Many PET dealers, or, 

ZZYP Data Processing 

2313 Morningside Drive 

Bryan, TX 77801 



Name: BULLS AND BEARS (tm) 
System: Apple II 
Memory : 1 6K 
Language: 16K BASIC 
Hardware: Apple II 

Description: A multi-player simulation 
of corporate finance. Involves deci- 
sion-making regarding production lev- 
els, financing, dividends, buying and 
selling of stock, etc. 
Copies: "Hundreds sold" 
Price: $12.00 

Includes: Game cassette and booklet. 
Ordering Info: At computer stores only 
Author: SPEAKEASY SOFTWARE LTD. 

Box 1200 

Kemptville, Ontario 

Canada K0G 1J0 

[Dealer inquiries invited] 



Name: A Variety of Programs 
System: Apple II 
Memory: Most 8K or less 
Language: Mostly Integer BASIC 
Hardware: Mostly standard Apple II 
Description: A varied collection of 
short programs. Some utilities, some 
educational. Included are: ALPHA SORT 
MUSIC ROUTINE, STOP WATCHBASIC DUMP, 
MULTIPLY, ONE-ARM-BANDIT, ... 
Copies: Varies, up to about 20. 
Price: $7-50 to $10.00 each. 
Includes: Apple II cassette and pro- 
gram listing. 

Ordering Info: Write for catalog. 
Author (s): Not specified. 
Available from: 

Apple PugetSound Prog. Lib. Exch. 

6708 39th Avenue SW 

Seattle, WA 98136 



Name: HELP Information Retrieval 
System: KIM-1 
Memory: Basic KIM-1 
Language: Assembler and HELP 
Hardware: KIM-1, terminal, cassettes 
Description: Permits the user to cre- 
ate a data base on cassette, and then 
perform a variety of searches on the 
data base. May make six simultaneous 
tests on FLAGS associated with the data 
plus one test on each of the six data 
fields. Permits very complex retrieval 
from the data base. Includes ULTRATAPE 
which reads/writes at 100 char /sec, 12 
times the normal KIM rate. 
Copies: 100+ 
Price: $15.00 

Includes: Cassette tape, 36 page User 
Manual, a Source Listing book and a 
Functions Manual which explains the 
operation of the HELP language. 
Ordering Info: Specify HELP Info Ret. 
Author: Robert M. Tripp 
Available from: 

Many 6502 Dealers, or, 

The COMPUTERIST, Inc. 

P.O. Box 3 

S. Chelmsford, MA 01824 
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THE MICRO SOFTWARE CATALOG: III 



Mike Rowe 
P.O. Box 3 
Chelmsford, MA 01824 



Name : LABELER 

System: TIM based or any 6502 based system 
Memory: 1K 
Language : Assembly 
Hardware: Paper Tape Punch on TTY 
Description: This program punches legible char- 
acters on a paper tape and is useful for the 
labeling of punched paper tapes. A 64 character 
sub-set of ASCII is used. There is limited 
editing capability on the data. There are a 
number of options for character size, starting 
address and TIM or I/O independent code. 
Copies: Not Specified 
Price: $4.00 

Includes : Commented source listing , operating 
and modifying instructions, and a hex tape. 
Ordering Info: Specify the following: 

Char Size 5x5 or 5x8 

Starting address 0200 or 1000 

System TIM or I/O Independent 
Author: Gil House 
Available from: 

Gil House 

P.O. Box 158 

Clarksburg, MD 20734 

Name : HUEY 

System: Any 6502 based system. 
Memory: 2.5K 
Language: Assembly 
Hardware: ASCII I/O device. 

Description: HUEY-65 is a scientific calculator 
program for the 6502 microprocessors. It oper- 
ates from your ASCII keyboard like a calculator; 
will output through your routines to a TV screen 
or Teletype; is preprogrammed to do trig func- 
tions, natural and common logs, exponential 
functions and other goodies; and is programmable 
for many other functions (financial, accounting, 
mathematics, engineering, etc.) you would like 
to call at the press of a single key. 
Copies: Not Specified. 
Price: Hex Dump at any even page - $5-00 

Manual and Listings - $20.00 
Ordering Info: Specify starting address. 
Author: Don Rindsberg 
Available from: 

The BIT Stop 

P.O. Box 973 

Mobile, AL 36601 



Name : Word Processor Program 

System : PET 

Memory: Not Specified. 

Language: Not Specified. 

Hardware : RS-232 printer addressed via a CmC 

printer adapter. 
Description: This program permits composing and 
printing letters, flyers, advertisements, manu- 
scripts, articles, etc., using the Commodore PET 
and an RS-232 printer. Script directives in- 
clude line length, left margin, centering, and 
skip. Edit commands allow the user to insert 
lines, delete lines, move lines, change strings, 
save onto cassette, load from cassette, move up, 
move down, print and type. 
Copies: Not Specified. 
Price : $29 • 50 
Ordering Info : None . 
Author (s): Not Specified. 
Available from: 

Connecticut microcomputer 

150 Pocono Road 

Brookfield, CT 06804 
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Name: ZIP TAPE 

System: KIM-1 , may be easily modified for any 
other 6502 system with programmable timer I/O 
Memory: 3/4 page each for read and write progs. 
Hardware: Simple single IC audio to logic level 
converter and output buffer/attenuator on 2" sq. 
board . Directional control , 4 connections to 
computer . 

Description: A fast audio cassette data record- 
ing and recovery system. Programmable to 4800 
baud. Loads 8K in less than 15 seconds. Fol- 
lows KIM-1 protocol of open ended record length 
with start address, end address, and record ID 
specified at usual KIM locations. Load by ID, 
ignore ID, and relocate modes. Data recorded in 
binary form with 2 byte checksum error detec- 
tion. Easily relocated, can either stand alone 
or be used as subroutines. Requires programm- 
able timer 1/0. 

Copies: About 12, just introduced. 
Price: $22.50 +1.00 ship 4 hand. $3.00 extra 
for KIM cassette. 

Includes: Assembled and tested interface, com- 
mented listings, suggested changes to run on TIM 
and other systems. Cassette has software recor- 
ded at HYPERTAPE and standard KIM speeds plus 8K 
test recording using ZIP TAPE. 
Ordering Info : With or Without tape . 
Author: Lewis Edwards, Jr. 
Available from: 

Lewis Edwards 

1451 Hamilton Avenue 

Trenton, NJ 08629 

Name: FOCAL* (*DEC Trademark) 
System: Apple II 
Memory: Not Specified. 
Language : Assembler 
Hardware: Apple II 

Description: This is an extended version of the 
high-level language called FOCAL. FOCAL was 
created for the DEC PDP-8. It is similar to 
BASIC. FCL65E, as this version is called, is 
now available for the Apple II. 
Copies: Not Specified. 

Price: Apple II format cassette - $25.00 
Mini-Manual - $6.00 
FCL65E User's Manual - $12.00 
Complete Source Listing - $35.00 
Ordering Info: Specify parts desired. 
Author(s): Not Specified. 
Available from: 

The 6502 Program Exchange 

2920 Moana 

Reno, NV 89509 

Name: WARLORDS 

System: Apple II (PET version under devel.) 
Memory: Not Specified 
Language: Not Specified 
Hardware : Apple II 

Description: It is the Dark Ages, in the king- 
dom of Nerd, and all is chaos. King Melvin has 
died without an heir and a dire power struggle 
is taking place to see who will emerge as the 
new King. You and the other players are the 
WARLORDS, and you will have to decide what com- 
bination of military might and skillful diplom- 
acy will lead you to victory. 
Copies: Not Specified 
Price: $12.00 

Ordering Info: Specify Apple II Version 
Author: Not Specified 
Available from: 

Dealers who carry software from 

Speakeasy Software LTD. 
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Names: E/65 and A/65 
System: Any 6502 based system 
Memory: Not Specified 
Language : Assembly 

Hardware: Terminal. Cassette optional. 
Description: E/65 is primarily designed to edit 
assembler source code. Line oriented commands 
specify input/out or text and find specific 
lines to be edited. String oriented commands 
allow the user to search for and optionally 
change a text string. Also character oriented 
commands and loading and dumping to bulk device. 
A/65 is a full two-pass assembler which conforms 
to MOS Technology syntax. A full range of run- 
time options are provided to control listing 
formats, printing of generated code for ASCII 
strings and generation of object code. 
Copies: Not Specified 
Price: $100 each 

Includes: Object form on paper tape or KIM type 
cassette. Listings of source code are available 
for $25.00 each. Full documentation on the in- 
stallation and use of each package is provided. 
Author: Not Specified 
Available from: 

COMPAS - Computer Applications Corporation 

P.O. Box 687 

Ames, IA 50010 



Name: Read/Write PET Memory 
System : PET 
Memory: 8K RAM 
Language : BASIC 
Hardware: Standard PET 

Description: Permits user to key into memory 
hex codes by typing hex starting address and 
then typing the hex digits in sequence desired. 
Display memory as both hex codes and assembly 
language mnemonics (translates relative address 
into actual hex address) . Stores memory on tape 
and loads memory from tape into any desired mem- 
ory location. Executes machine-language pro- 
grams. 

Copies: Just released - 32 sold first day. 
Price: $7-95 - postpaid 

Includes: Cassette tape; complete instructions 
(including use of ROM subroutines to input and 
output memory from keyboard and to screen) . 
Ordering Info: From author 
Author : 

Don Ketchum 

313 Van Ness Avenue 

Upland, CA 91786 

(Dealer Inquities Invited) 



PROGRAMMING A NICRO-CONPUTER: 6502 

by Caxton C. Foster 

(Reviewed by James R. Witt, Jr.) 



For those of you in the computing world who have 
recently purchased or constructed a microcompu- 
ter based on the 6502 microprocessor (the KIM-1 
fits this description) and can't put it to rea- 
sonably practical use , then perhaps your head- 
aches are over! Programming a Micro-Computer: 
6502 by Caxton C. Foster may be exactly what 
you need to halt your frustrations. Foster pre- 
sents the reader with a combination of reference 
manual for programming and an introduction to 
6502 systems, specifically using the KIM-1 as a 
model . 

The motivation behind Foster's work is practi- 
cality. Right from the beginning of the first 
chapter a hypothetical situation is introduced, 
circumstances that one might face in the course 
of an average day, and the microcomputer is sug- 
gested as a solution. Initially, a simple prob- 
lem is introduced , a problem one would not ex- 
pect a computer to solve due to its simplicity. 
Yet , this enables the reader to grasp the basic 
operation of running an uncluttered program suc- 
cessfully. Possible reasons as to why a certain 
program fails are provided to lessen confusion. 

With successful completion of one program, the 
author wastes no time moving on to new situa- 
tions . This may seem somewhat fast and confus- 
ing to those who greet micros as a totally new 
experience . Yet the situations do become more 
interesting and more challenging to solve by 
computer software. Such programs include: 



"Keybounce" , "A Combination Lock", and "Digital 
Clock" among others. Several of these programs 
are completely legitimate and fully operable. 

As noted before, Foster moves at a swift pace. 
At certain points, various instructions and 
KIM-1 anatomy are condensed into a mere page or 
two. Basic understanding of digital electronics 
is assumed often and may be required before 
fully digesting some of this material. These 
two minor weaknesses may tend to boggle the mind 
of the newcomer and hinder his ■ comprehension of 
the purpose of programming and its make-up. 

Suggestions : For those who are newcomers to the 
"sport" of computing and digital electronics, 
you may want to consider some other preliminary 
instructions BEFORE undertaking this book. If 
you have some sense of digital, but little know- 
ledge of micros, you should tackle it, but 
should make notes of important items the first 
time through each chapter, and then reread the 
chapter to pull the odds and ends together. If 
you have written simple programs but have an 
appetite for more complex proglem-solving , then 
Programming A Micro-Computer: 6502 will be a 
definite aid and resource in satisfying your 
hunger . 



Programming A Micro-Computer: 6502, by Caxton 
C. Foster, published by Addison-Wesley, 1978. 



\. 



150 



iQjMQia® 




6502 INFORMATION! RESOURCES 

William R. Dial 
438 Roslyn Ave. 
Akron, OH 44320 



Did you ever wonder just what magazines were the 
richest sources of information on the 6502 
microprocessor , 6502-based microcomputers , acc- 
essory hardware and software? For several years 
this writer has been assembling a bibliography 
6502 references related to hobbv computers and 
small business systems (see MICRO No's 1, 3> 
4, 5, and 6). A review of the number of times 
various magazines are cited in the bibliography 
gives a rough measure of the coverage of these 
magazines of 6502 related subjects. Even after 
such a f equency chart is compiled , an accurate 
comparison is difficult. Some of the magazines 
have been published longer than others. Some 
periodicals have been discontinued, others have 
been merged with continuing publications. Some 
give a lot of information in the form of ads, 
others are devoted mostly to authored articles. 
Regardless of the basis of the tabulation of 
references, however, some publications are 
clearly more useful sources of information on 
the 6502 than others. 

The accompanying list of magazines has been 
compiled from the bibliography. At the top of 
the list are several publications which special- 
ize in 6502-related subjects. These include 
this publication, MICRO, as well as the KIM-1 
/6502 USER NOTES. Also in this category is 
OHIO SCIENTIFIC'S SMALL SYSTEMS JOURNAL, a 
publication which covers hardware and software 
for the Ohio Scientific 6502-based computers. 
KILOBAUD, BYTE and DR. DOBB'S JOURNAL all give 
good coverage on the 6502 as well as other 
microprocessors. KILOBAUD has more hardware and 
constructional articles than most computer mag- 
azines. ON-LINE is devoted mainly to new pro- 
duct announcements and has very frequent refer- 
ences to 6502 related items. Following these 
oome a group of magazines with somewhat less 
frequent references to the 6502. Finally toward 
the end of the list are those magazines with 
only occasional or trivial references to the 
6502. An attempt has been made to give up-to- 
date addresses and subscription rates for the 
magazines cited . 



MICRO 

$6.00 per 6 issues 

MICRO 

P.O. Box 3 

S. Chelmsford, MA 01824 

KIM- 1/6502 USER NOTES 
$5.00 per 6 issues 

Eric Rehnke 

P.O. Box 33077 

Royal ton, OH 44133 

OHIO SCIENTIFIC— SMALL SYSTEMS JOURNAL 
$6.00 per year (6 issues) 

Ohio Scientific 

1333 S. Chillicothe Rd. 

Aurora, OH 44202 

KILOBAUD 
$15.00 per year 

Kilobaud Magazine 

Peterborough, NH 03458 



BYTE 

$12.00 per year 

Byte Publications, Inc. 

70 Main St. 

Peterborough, NH 03458 

DR. DOBB'S JOURNAL 

$12.00 per year (10 issues) 

People's Computer Co. 

Box E 

1263 El Camino Real 

Menlo Park, CA 94025 

ON-LINE 

$3-75 per year (18 issues) 

D. H. Beetle 

24695 Santa Cruz Hwy 

Los Gatos, CA 95030 

PEOPLE'S COMPUTERS (Formerly PCC) 
$8.00 per year (6 issues) 

People's Computer Co. 

1263 El Camino Real 

Box E 

Menlo Park, CA 94025 

INTERFACE AGE 
$14.00 per year 

McPheters, Wolfe & Jones 

16704 Marquardt Ave. 

Cerritos, CA 90701 

POPULAR ELECTRONICS 
$12.00 per year 

Popular Electronics 

One Park Ave. 

New York, NY 10016 

PERSONAL COMPUTING (Formerly MICR0TREK) 
$14.00 per year 

Benwill Publishing Corp. 

1050 Commonwealth Ave. 

Boston, MA 02215 

73 MAGAZINE 
$15-00 per year 

73, Inc. 

Peterborough, NH 

CREATIVE COMPUTING 
$15.00 per year 

Creative Computing 

P.O. Box 789-M 

Morristown, NJ 07960 

SSSC INTERFACE 

(Write for information) 

Southern California Computer Soc. 

1702 Ashland 

Santa Monica, CA 90405 

EDN (Electronic Design News) 

$25-00 per year 

(Write for subscription info) 

Cahners Publishing Co. 

270 St Paul St. 

Denver, CO 80206 
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RADIO ELECTRONICS 
$8.75 per year 

Gernsback Publications, Inc. 

200 Park Ave . , South 

New York, NY 10003 

QST 

$12.00 per year 

American Radio Relay League 

225 Main St. 

Newington, CT 06111 

IEEE Computer 

(Write for subscription info) 

IEEE 

345 E. 47th St. 

New York, NY 10017 

ELECTRONICS 
$14.00 per year 

Electronics 

McGraw Hill Bldg. 

1221 Ave. of Americas 

New York, NY 10020 

POLYPHONY 
$4.00 per year 

PAIA Electronics, Inc. 

1020 W. Wil shire Blvd. 

Oklahoma City, OK 73116 

CALCULATORS, COMPUTERS 
$12.00 per year (7 issues) 

Dynax 

P.O. Box 310 

Menlo Park, CA 94025 



COMPUTER MUSIC JOURNAL 
$14.00 per year (6 issues) 

People's Computer Co. 

Box E 

1010 Doyle St. 

Menlo Park, CA 94025 

POPULAR COMPUTING 
$18.00 per year 

Popular Computing 

Box 272 

Calabasas, CA 91302 

MINI-MICRO SYSTEMS 

$18.00 per year 

Modern Data Service 

5 Kane Industrial Drive 

Hudson, MA 01749 

DIGITAL DESIGN 

$20.00 per year 

(Write for subscription info) 

Benwill Publishing Corp. 

1050 Commonwealth Ave. 

Boston, MA 02215 

ELECTRONIC DESIGN 

(26 issues per year) 

(Write for subscription info) 

Hayden Publishing Co., Inc 

50 Essex St. 

Rochelle Park, NJ 07662 

HAM RADIO 

$12.00 per year 

Communications Technology 
Greenville, NH 03048 



COMPUTER WORLD 

$12.00 per year (trade weekly) 

(Write for subscription info) 

Computer World 

797 Washington St. 

Newton, MA 02160 



Editor's Note: In addition to the magazines 
regularly covered by the 6502 Bibliography, the 
following magazines may also be of interest to 
various 6502 readers: 



PET GAZETTE 

Free bi-monthly (Contributions Accepted) 
Microcomputer Resource Center 
1929 Northport Drive, Room 6 
Madison, WI 53704 

Robert Purser's REFERENCE LIST 

OF COMPUTER CASSETTES 
Nov 1978 $2.00/Feb 1979 $4.00 

Robert Purser 

P.O. Box 466 

El Dorado, CA 95623 

THE SOFTWARE EXCHANGE 
$5.00 per year (6 issues) 

The Software Exchange 

P.O. Box 55056 

Valencia, CA 91355 



THE PAPER 

$15.00 per year (10 issues) 

The PAPER 

P.O. Box 43 

Audubon, PA 19407 

PET USER NOTES 

$5.00 per year (6 or more issues) 

PET User Group 

P.O. Box 371 

Montgomeryville , PA 18936 

CALL A.P.P.L.E 

$10.00 per year (includes dues) 

Apple Puget Sound Program Library Exchange 

6708 39th Ave. SW 

Seattle, WA 98 136 
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6502 BIBLIOGRAPHY 

William Dial 

438 Roslyn Avenue 

Akron, OH 44320 

1. MOS Technology, Inc., 950 Rittenhouse Rd., Norristown, PA 19401 "KIM-1 Microcomputer 
Module Users Manual (1975)" 

2. MOS Technology, Inc., 950 Rittenhouse Rd., Norristown, PA 19401 "6502 Programming 
Manual" 

3. MOS Technology, Inc., 950 Rittenhouse Rd., Norristown, PA 19401 "6502 Hardware Manual" 

4. Fylstra, Daniel, "Son of Motorola (or the $20 CPU chip)" Byte 1 No. 2, pp. 56-62 (November 
1975) 

Notes on the introduction of the MOS Technology MCS 6500 series microprocessors. 

5. MOS Technology, Inc., 950 Rittenhouse Rd., Norristown, PA 19401 "MCS 6500 Microcom- 
puter Family Cross Assembler Manual — Preliminary" (August 1975) 

6. Rehnke, Eric C, Editor, "KIM-1/6502 Users Notes", P.O. Box 33077, North Royalton, OH 44133 

Published about 6 times per year. The single most useful source of programs and miscellan- 
eous information on the KIM-1. 

7. MOS Technology, Inc., 950 Rittenhouse Rd., Norristown, PA 19401 "Users Manual — Memory 
Expansion Modules KIM-2 and KIM-3" (September 1976) 

8. MOS Technology, Inc., 950 Rittenhouse Rd., Norristown, PA 19401 Flyer ca. March 1976 — 
"MCS 6530 Memory, I/O, Timer, Array" 

A description of the 6530 ROM used on KIM-1. 

9. MOS Technology, Inc., 950 Rittenhouse Rd., Norristown, PA 19401 "TIM Manual " (March 1976) 

10. MOS Technology, Inc., 950 Rittenhouse Rd., Norristown, PA 19401 "KIM-1 Application Note 
No. 2" 

Describes Interval Timer Operation. Helps to clarify the use of the timer. See also examples in 
the KIM monitor 6530-002 and -003. 

11. Ohio Scientific Instruments, 11679 Hayden Ave., Hiram, OH 44234 "Model 300 Computer — 
Trainer Lab Manual" 

A series of 20 programs for instruction on the 6502 microprocessor based Model 300 Trainer. 
Programs are easily adapted to KIM-1 operation. 

12. Ohio Scientific Instruments, 11679 Hayden St., Hiram, OH 44234 "OSI Application Note No. 1" 

Covers 6530 TIM Monitor. 

13. Ohio Scientific Instruments, 11679 Hayden St., Hiram OH 44234 "Application Note No. 2" 

OSI 480 Backplane and Expansion System. 

14. Ohio Scientific Instruments, 11679 Hayden St., Hiram, OH 44234 "OSI Application Note No. 
5" 

Interfacing OSI Boards to other systems including KIM-1. 

15. Ohio Scientific Instruments, 11679 Hayden St., Hiram, OH 44234 "OSI Model 430 Super I/O 
Board Instruction Manual" 

16. Ohio Scientific Instruments, 11679 Hayden St., Hiram, OH 44234 "Model 420C, 4K Memory 
Expansion Board" 

Instruction Manual — use together with OSI Application Note No. 2 on the 480 Backplane 
and Application Note No. 5 on interfacing OSI boards to other systems including KIM-1. 

17. ON-LINE, 24695 Santa Cruz Hwy., Los Gatos, CA 95030 

This classified ad newsletter often announces KIM-1 and 6502 software and hardware acces- 
sories. 18 issued $3.75. 

18. Helmers, Carl, "There's More to Blinking Lights Than Meets the Eye" Byte 1, No. 5, pp.52-54 
(January 1976) 

A program for creating patterns of flashing lights (LEDs). 

19. Lloyd, Robert G., "There's More to Blinking Lights, etc." KIM-1/6502 Users Notes 

A KIM-1 version of Carl Helmers earlier program in Byte. 

20. Ziegler, John, "Breakpoint Routine for 6502" Dr. Dobbs Journal 1, No. 3, pp. 17-19 (1976) 

Requires a terminal and a TIM Monitor. Upon entering, the program counter is printed, 
followed by the active flags, accumulator, register, Y register and stack pointer. 
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21. Anon., "What's New Kim-o-sabee?" Byte 1, No. 8, p. 14 (April 1976) 

Brief notes on KIM-1. 

22. Simpson, Richard S., "A Date with KIM" Byte 1, No. 9, pp. 8-12 (May 1976) 

A description of the features of KIM-1. 

23. Microcomputer Associates, 111 Main St., Los Altos, CA 94022 "Jolt Microcomputer" Radio- 
Electronics 47, No. 6, p.66 (June 1976) 

Includes description of JOLT, based on 6502, and gives demonstration program using DEMON 
Monitor. 

24. Travis, T.E., "KIM-1 Microcomputer Module" Microtrek, pp. 7-16 (August 1976) 

Notes and programs for KIM-1 including Drunk test and several useful routines. 

25. Anon., "MOS Technology - KIM MCS 6502" Interface Age 1, No. 9, pp. 12, 14 (August 1976) 

An announcement of the KIM-1. 

26. Rankin, Roy and Wozniak, Steve, "Floating Point Routines for the 6502" Dr. Dobbs Journal 1 
No. 7, pp. 17-19 (August 1976) 

Calculation from 10" 3 8 to 10 +3 8 with 7 significant digits. 

27. Bradshaw, Jack, "Monitor for the 6502" Dr. Dobbs Journal 1, No. 7, pp. 20-21 (August 1976) 

Monitor a la OSI. 

28. Garetz, Mark, "Lunar Lander for the 6502" Dr. Dobbs Journal 1, No. 7, pp. 22-25 (August 1976) 

A game requiring TIM Monitor and a terminal. 

29. Gupta, Yogesh M., "True Confessions: How I Relate to KIM" Byte 1, No. 12, pp. 44-48 
(August 1976) 

A series of notes on KIM-1. Includes Clock Stretch and Random Access Memories, Bus Ex- 
pansion and modification of drive capability using tristate drivers, Interrupt Prioritizing Logic 
and Halt Instruction. 

30. Thompson, Geo. L., "KIM on, Now" Byte 1, No. 13, pp. 93-94 (September 1976) 

Notes on using KIM-1. 

31. Wozniak, Steve, "Mastermind: A Number Game for the 6502" DDJ 1, No. 8, pp. 26-27 
(September 1976) 

A number game adaptable to KIM-1 with terminal. 

32. Baum, Allen and Wozniak, Stephen, "A 6502 Dissembler" Interface Age 1, No. 10, pp. 14-23 
(September 1976) 

33. Kjeldsen, Tony, "Next of KIM" (letter) Byte 1, No. 14, p. 136 (October 1976) 

34. Pittman, Tom, "Tiny Basic for 6502" DDJ 1, No. 9, pp. 22-23 (October 1976) 

Available from Itty Bitty Computers. TB650K (0200-OAFF) is for KIM and most homebrew 
6502 systems with RAM in first 4K memory. 

35. Anon., "Build a Simple A to D" Interface Age 1, No. 12, pp. 12-14 (November 1976) 

Simple circuit, 6502 software, 16 locations. Use to interface a pot or a joystick. 

36. Rankin, Roy and Wozniak, Stephen, "Floating Point Routines for 6502" Interface Age 1, No. 
12, pp. 103-111 (November 1976) - See also DDj\ No. 7, pp. 17-19 (August 1976) 

Contains good annotated listings. Loads 1DOO-1FEE. 

37. Ohio Scientific Instruments, 11679 Hayden St., Hiram, OH 44234 Flyer: "OSIs New 8K Basic 
for 6502" 

Written by Microsoft. Has automatic string space handling and runs up to 8 times faster than 
8080 Basic. Cost $50. 

38. Cybersystems, Inc., 4306 Governors Drive West, Huntsville, AL 35805 Flyer: "The Microcyber 
1000" 

A complete microcomputer system based on a repackaged KIM-1. Provides power supply, 
two separate ports for I/O, TTY connector, Audio Cassette connector, room for expansion 
board, etc. 

39. Microsoftware Specialists, Inc., 2024 Washington, Commerce, TX 75428 Flyer: Assembler/ 
Text Editor Program (4K) 

Compatible with MOS Technology Assembler. Documentation and cassette $19.50. 

40. United Microsystems Corp., 2601 S. State St., Ann Arbor, MI 48104 Flyer: "UMC KIM/ALPHA" 

A modular system based on memory modules of 4K and 8K, full keyboards, modular back- 
planes. Cost ca. $700. Video monitor extra. 
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41. Riverside Electronic Design, Inc., 1700 Niagara St., Buffalo, NY 14207 Flyer: "KEM, KIM-1 
Expansion Module and MVM-1024, Microprocessor Video Module" 

Used for expansion of KIM-1 system with boards having S-1-- edge connectors ASCII key- 
board interface. MVM-1024 is a video display board, scrolling, edit functions, 16 rows of 
characters, blinking cursor, etc. 

42. 6502 Program Exchange, 2920 Moana, Reno, NV 89509 Flyer of April 1977 lists 7 programs for 
KIM-1 with 1 to 4K of memory and keyboard facilities. 

43. DATA1-K Assembler Flyer November 10, 1976 

A resident assembler for KIM-1. Model DATA1-K is compatible with MOS Technology Cross 
Assembler Language. 

44. Pollock, James W., "1000 WPM Morse Code Typer" 73 Mag. No. 196, pp. 100-103 (January 1977) 

Use of KIM-1 for sending code at 9-1000 WPM from a keyboard. 

45. Robbins, Carl M., "The Microprocessor and Repeater Control" QST 61, No. 1, pp. 30-34 
(January 1977) 

KIM-1 control of repeater functions. 

46. Inman, Don, "Data Handler Users Manual" Peoples Computer Co. 5, No. 4, pp. 10, 11, 13 
(January-February 1977) Peoples Computer Co. 5, No. 5, pp. 16, 17, 18 (March-April 1977) 
Peoples Computer Co. 5, No. 6, pp. 52, 53, 55 (May-June 1977) 

A how-to course in 6502 programming. 

47. Miller, Lindsay, "Found, A Use for Your Computer" Kilobaud, Issue No. 2, p. 80 (February 1977) 

A clock program for the KIM-1. 

48. Gordon, H.T., "Stringout Mods" DDJ 2, No. 2, p. 8 (February 1977) 

A 6502 program applicable to KIM-1 to relocate blocks of instructions in RAMs. 

49. Fugitt, Lemuel A., "A 6502 Op Code Table" Byte 2, No. 3, p. 36 (March 1977) 

See also Allen, Syd, "6502 Op Code Table" in KIM-1/6502 Users Notes, Issue 4, p. 9 
(March 1977). 

50. Kushnier, R., "A Partial KIM-1 Bibliography" KIM-1/6502 Users Notes No. 4, p. 7 (March 1977) 

51. Cushman, Robert H., "Bare-bones Development Systems Make Good Learning Tools" EDN 22, 
No. 6 (March 20, 1977) See also 22, No. 8, pp. 104-111 (April 20, 1977) 22, No. 4, pp. 89-92 
(February 20, 1977) 22, No. 10, pp. 84-90 (May 20, 1977) 22, No. 12, pp. 79-84 (June 20, 1977) 

Use of KIM-1 in a music program is detailed in April 1977 issue. 

52. Salter, Richard J. and Burham, Ralph W., "Navigation with Mini-0" Byte 2, No. 4, pp. 100-109 
(April 1977); See also Byte 2, No. 2, p. 62 (February 1977) and Byte 2, No. 3, p. 70 (March 1977) 

Several articles in a series on the Omega Navigation System and the Mini-0 Receiver driven 
by a KIM-1 processor. Developed at the Ohio University Avionics Engineering Center. 

53. Haas, Bob, "KIM-1 Memory Expansion" Kilobaud, No. 4, pp. 74-76 (April 1977) 

Adding the S.D. Sales 4K Low Power RAM board to KIM-1. 

54. Sherman, Ralph, "A 650X Program Relocater" DDJ 2, No. 4, pp. 30-31 (April 1977) 

55. Ockers, Stan, "TV Sketch Program" DDJ 2, No. 4, pp. 32-33 (April 1977) 

A program for use with KIM-1 equipped with a Southwest Tech Prod Co. Graphics Board 
GT 6144. 

56. Jennings, Peter R., "Microchess" DDJ 2, No. 4, p. 33 (April 1977) 

Description of chess playing program. Cost $10. 

57. Wear, Tom, 380 Belaire, Punta Gorda, FL 33950, Private Communication April 20, 1977 

Information on bringing up new memory boards with KIM-1, including OSI 420 and OSI 480 
backplane. Includes a very nifty memory test routine for checking the operation of memory 
boards. See also KIM-1/6502 Users Notes No. 5, p. 4 (May 1977). 

58. Loffbourrow, Tod Interface Age (April 1977) 

All about a robot named Mike - based on KIM-1. 

59. Tripp, Robert M., "PLEASE" Flyer: The Computerist, May 1977 

Fun and Games with KIM-1. A cassette in Supertape for fast loading into KIM-1. Has a 
number of interesting programs including clock, timer, billboard, travelling display, drunk 
test, Hi-Lo number game, etc. Available for $10 from Robert M. Tripp, P.O. Box 3, S. 
Chelmsford, MA 01824. 

60. Jennings, Peter, "Microchess" The Computerist Flyer, May 1977 

Play Chess with KIM-1 with no additional peripherals or memory. Availble from Robert M. 
Tripp for $15. 
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61. The Computerist, P.O. Box 3, S. Chelmsford, MA 01824 Flyer May 2, 1977 

Offers power supplies for KIM-1, also a relay kit to permit KIM to control two reed relays for 
two cassette recorders. 

62. Computer Shop, 288 Norfolk St., Cambridge, MA 02139 Adv. in The Computerist, p. 18, 
May 1977 

Offers a 4K RAM board for $74.50 that can be used with KIM-1. 

63. Riverside Electronics, 1700 Niagara St., Buffalo, NY 14207 Advertisement. See KIM-1/6502 
Users Notes No. 5 (May 1977) 

Offers 5 Application Notes for $1 on the use of their MVM-1024 and KEM expansion boards. 
Ask for MVM-1, 2, 3, 4, 5 and KIM-1. 

64. Aresco, 314 Second Ave., Hahhon Hts., NJ 08035 See KIM-1/6502 Users Notes, Issue No. 5, 
p. 1 (May 1977) 

Lists several programs available for KIM, TIM, etc. 

65. Simpson, Rick, "Come Fly with KIM" Byte 2, No. 6, pp. 76-80 (June 1977) 

Load 12K of memory in two minutes with a "Fly Reader" for paper tape. 

66. Lancaster, Don, "A TVT for your KIM" Kilobaud, No. 6, pp. 50-63 (June 1977) 

TVT-6L is a low cost method of providing a TV monitor for KIM-1. Uses minimum new hard- 
ware but depends on a software program in KIM-1 memory for handling characters. Uses a low 
cost TV (Pansonic T-126A) for monitor. 

67. Lancaster, Don, "Build the TVT-6" Popular Electronics 12, No. 1, pp. 47-52 

A low cost direct video display based on KIM-1 software and a minimum of added hardware. 
Slightly different than the TVT-6L. 

68. Pickles and Trout, P.O. Box 2270, Goleta, CA 93018 "TV Mod Kit" 

Detailed instructions and kit of parts for conversion of a low cost ($80 approx.) Hitachi SX 
Chassis (Model P-04, P-08, PA-8, etc.) for a TV Monitor. 

69. Forethought Products, P.O. Box 386, Coburg, or "KIMSI" The Computerist, p. 8 (June 1977) 

KIMSI is a motherboard/Interface that allows KIM-1 to be interfaced to an S-100 bus; 8 slots. 

70. MOS Technology/Commodore "PET" The Computerist, p. 17 (June 1977) 

An announcement on PET, a new 6502 system with video monitor, ASCII keyboard, 12 K 
ROM including 8 K Basic and 4 K RAM, audio cassette; price ca. $4.95, available September 
1977. 

71. Grater, Robert, "Giving KIM Some Fancy Jewels" Byte 2, No.7, pp. 126-127 (July 1977) 

Adding a remote LED display for the KIM-1. 

72. Runyan, Grant, "The Great TV to CRT Monitor Conversion" Kilobaud, No. 7, pp. 30-31 (July 
1977) 

Although not specific to KIM-1, this article is useful in adapting a monitor to KIM. Uses in- 
expensive 12" Hitachi Model P-04, P-08, PA-4, PA-8. See also Sams Photofact Folder 1 Set 
1601 or Folder 3 Set 1501. 

73. Simpson, Richard, "KIM Forum" Kilobaud, No. 7, pp. 4, 19, 86 (July 1977) 

KIM-5 will be a ROM expansion board with up to 8 MCS 6504 (2K x 8) mask programmed 
ROMs. One ROM is KIMath, a set of subroutines for doing floating point arithmetic. Cost 
$50. Programming Manual for KIMath purchased separately is $15. Also a resident assembler 
and text editor are available as a set of 3 ROMs. 

74. Tripp, Robert M., "The 6502 World" The Computerist, p. 16 (July 1977) 

MOS Technology may offer a 16K RAM board for KIM-1. New KIM repair facility is KIM 
Diagnostig Center 2967 W. Fairmont Ave. Phoenix, AZ 85017 Tele. 602-248-0769 
4K Ram for KIM-1 assembled and tested for only $129 available from Tripp. 

75. Tripp, Robert M., "HELP Relay Package" The Computerist Flyer July 5, 1977 

Components for relay control of 2 cassette recorders. Includes control program subroutine. 

76. Tripp, Robert M., "4K RAM Board" The Computerist Flyer July 5, 1977 

4K for KIM-1, socketed chips, 5.25" x 9.25" board, can separately address each IK. Cost 
$129 assembled. 

77. Tripp, Robert M., "Digital to Analog Converter" The Computerist Flyer July 1977 

Micro Technology Unlimited DAC board with audio output to drive 8/16 ohm speakers. Can 
play 4 part harmony with only KIM-1. Includes cassette tape program for tunes. 

78. Tripp, Robert M., "Mod to Improve the PLEASE Clock" The Computerist July 5, 1977 
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79. Boyle, Peter, "The Gory Details of Cassette Storage" Kilobaud, No. 3, pp. 116-119 (March 1977) 

Comments on audio cassette problems. States that KIM runs at 133 baud but is capable of 
1200 baud. 

80. Johnson Computer, P.O. Box 523, Medina, OH 44256 "Basic for KIM-1" /xP No. 4 (June 1977) 

Resides in 2K at address 2000. Available in paper tape $5. 

81. Johnson Computer, P.O. Box 523, Medina, OH 44256 "Harness Eliminator" /jlP No. 4 (June 1977) 

Minimize wiring in connecting KIM 2 or 3 to KIM-1 with a rigid coupling. 

82. Johnson Computer, P.O. Box 523, Medina, OH 44256 "KIM-1 Resident Assembler/Text Editor 
Model DATA1-K" juP No. 4 (June 1977) 

Use with MOS Tech Cross Assembler Manual. 

83. Johnson Computer, P.O. Box 523, Medina, OH 44256 "KIMath — Floating Point Math Package" 
MP No. 4 (June 1977) 

Rom is $50. Documentation alone $15. Available from Johnson Computer. 

84. Tripp, Robert M., "Is the KIM-1 for Every-1" Kilobaud, No. 8, pp. 56-57 (August 1977) 

General description of KIM-1. 

85. Fish, Larry, "Troubleshoot Your Software" Kilobaud, No. 8, pp. 112-113 (August 1977) 

A trace program for 6502. 

86. Severson, Gerald D., "Plaudits for MOS Technology" DDJ 1, No. 6, pp. 5 (June-July 1976) 

Note on good service from MOS technology on the 6502. 

87. Western Data Systems, 3650 Charles St., No. Z, Santa Clara, CA 95050 "Western Data's 6502- 
Based Data Handler" DDJ 1, No. 6, p. 43 (June-July 1976) 

A $170 kit with hex keyboard, LED binary readout, 1 K ram, capability of addressing 65K, 
uses 100 pin tustate bus and is compatible with a long list of Altair peripherals, 100 pin 
connector. 

88. Espinosa, Chris, "A String Output Subroutine for the 6502" DDJ 1, No. 8, p. 33 (September 
1976) 

This routine saves pointers, loops, etc. in outputting the string. 

89. Meier, Marcel, "6502 String Output, Revisited" DDJ 1, No. 10, p. 50 (November 1976) 

Further mod of Espinosa 's earlier routine. 

90. Anon., "That didn't Take Long at All" Byte 1, No. 5, p. 74 (January 1976) 

Note on 6502 product introduction and the JOLT computer kit. 

91. Anon., "Control Logic for Microprocessor Enables Single Step" Electronic Design, p. 78 (Oct- 
ober 11, 1976) 

Uses 6502 system. 

92. Anon., "6502 Disassembler" Interface Age, p. 14 (September 1976) 

93. Butterfield, Jim, "KIM Goes to the Moon" Byte 2, No. 4, pp. 8-9, 132 (April 1977) 

A lunar lander program; see also same program in KIM-1/6502 users notes. 

94. Hybrid Technologies, P.O. Box 163, Burnham, PA 17009 "Ad for KIM-1 Peripherals" Byte 2, 
No. 8, p. 157 (August 1977) 

2K/8K ROM based, EProm Programmer, 2K/4K/8K Ram boards, assembler board, TV Inter- 
face board, relay board, mother boards. 

95. Simpson, Richard, "Circular Ad for 6502 Software" Aresco, 314 Second Avenue, Haddon 
Heights, NJ 08035, July 26, 1977 

Describes FOCAL, a 4K language similar to BASIC, and a 2.5K resident assembler suitable for 
all 6502-based micro systems. 

96. Commodore International, Ltd., 901 California Avenue, Palo Alto, CA 94304 Tele. (415) 326- 
4000 "The PET! " Peoples Computers 6, No. 1, p. 59 (July-August 1977) 

An announcement of the PET computer based on 6502. Available early September 1977 for 
$595. 

97. Crow, Darrell — Microcomputer Associates, 2589 Scott Blvd., Santa Clara, CA 95050 Tele. 
(408) 247-8940 "6502 Assembler, Tinz Basic on ROM's" Peoples Computers 6, No. 1, p. 60 
(July-August 1977) 

RAP is a 1.75K Resident Assembler Program on two 2K ROM's together with 2.2K Tinz 
Basic, pin compatible with 2708-type PRoms — price $200. 

98. Inman, Don, "The Data Handler Users Manual Part 4" Peoples Computers 6, No. 1, pp 42-46 
(July-August 1977) (Cont. from Item 46) 

Covers indexed addressing. 
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99. Anon., "User Group Being Formed for Commodore PET 2001 Computer" ON LINE 2, No. 10 
p. 11 (August 3, 1977) 

Membership is $5 including User Notes. Contact Gene Beals, P.O. Box 371, Montgomerv- 
ville, PA 18936. 

100. Anon., "6502 Assembler/Text-Editor for KIM-1 and TIM" ON LINE 2, No. 10, p. 10 (August 
3,1977) 

Resides in 2K, requires Teletype or CRT and cassette recorder. $29.95. M.S.S., Inc., 1911 
Meadow Lane, Arlington, TE 76010 

101. Anon., "MICRO- ADE" ON LINE 2, No. 10, p. 6 (August 3, 1977) 

New Product Announcement by MICRO-WARE Ltd., 27 Firstbrooke Rd., Toronto, Canada, 
M4E2L2 Micro-Ade, a 4K package is a compact development tool for all 6502 users in- 
cluding KIM-1. User manual, hex dump, object program on paper tape or KIM cassette is 
$25. Complete annotated source listing is available for another $25. 

102. Ohio Scientific Instruments, 11679 Hayden, Hiram, OH 44234 

OSI Small Systems Journal (first regular July 1977) is a new publication, $6 for six issues, 
devoted to 6502 and OSI users. 

103. Deckant, Gary, "Understanding and Using the 6502 Assembler" OSI Small Systems Journal 1, 
No. 1, p. 8 (July 1977) 

Explains use of assembler program. 

104. Anon., "IK Corner" OSI Small Systems Journal 1, No. 1, p. 8 (July 1977) 

The game of 23NIMB for OSI 65V systems. Requires terminal. Resides 0200-0332. 

105. Cheiky, Mike and Meier, Marcel, "The Auto-Load Cassette System" OSI Small System Jour- 
nal 1, No. 1, pp. 9-14, (July 1977) 

For OSI 65V system. 

106. Anon., "The 6502 Disassembler — From Object to Source End" OSI Small System Journal 1, 
No. 1, pp. 14-15 (July 1977) 

A disassembler is a program which attempts to convert machine code back into assembler 
source. Obviously it cannot reconstruct comments or labels. Points out other pitfalls in 
using disassemblers. 

107. Pyramid Data Systems, 6 Terrace Ave., New Egypt, NJ 08533 Ref :KIM-1/650X, Users Notes 
No. 6, p. 1 (July 1977) 

XIM is an extended I/O monitor package for Kim, residing in about IK memory. Adds 17 
commands to terminal equipped Kim. Has 45-page user manual. Cost $12.00 for manual 
and KIM cassette. 

108. ORB, P.O. Box 311, Argonne, 111., 60439, "The First Book of KIM" Ref: KIM-1/650X, 
Users Notes No. 6, p.l (July 1977) 

Ockers, Rehnke and Butterfield have collaborated in a 180-page new book to guide be- 
ginners and others in the use and enjoyment of KIM-1. Cost $9.50 including postage. 

109. Aresco, 314 Second Ave., Haddon Hts., NJ 08035, "Comprehensive 650X Assembler/Text 
Editor" Ref: KIM-1/650X Users Notes No. 6, p. 4 (July 1977) 

Designed for use with KIM-1 but can be used with other 650X systems such as TIM, Apple, 
Baby, OSI, etc. — Occupies 6K, available on KIM cassette or KIM-TIM paper tape. Cost 
$60.00. 

110. Bates, Dan, Rt 7, Box 310, Claremore, Okla, 74017, "Small Microcomputer Board using 6505. 
Ref: KIM-1/650X, Users Notes No. 6, p. 9 (July 1977) 

Bates has developed a board around the 28 pin 6505 and sells the 6" x 4" PC board for 
$15.00 including schematic and assembly instructions. Can handle ASCII to Baudot, micro- 
controlled repeater /autopitch, etc. 

111. Laabs, John, "Build a $20 EPROM Programmer" Kilobaud No. 9, pp. 70-77, (Sept 1977) 

KIM-1 is used to run software and some external hardware to program the 5204 4K EPROM. 

112. Ohio Scientific Instruments, Hiram, Ohio, 44234, "A Computer that Thinks in BASIC" Kilo- 
baud No. 9, p. 10, (Sept 1977) 

Announcement of OSI's Model 500 CPU board built on 6502. Complete with 8K Basic in 
ROM for $298. 

113. Clarke, Sheila, "A PET for Every Home" Kilobaud No. 9, pp. 40-42, (Sept 1977) 

A look at the Commodore PET 2001 based on the 6502. About $600 includes Video term- 
inal keyboard, 12K, (8K Basic in ROM and 4K operating system). 
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114. American Institute for Professional Education, Carnegie Bldg., Hillcrest Road, Madison, NJ, 
07940, "Microprocessing Fundamentals" Circular Advertisement — approx. Aug. 15, 1977. 

Dr. Joseph B. Ross, Purdue Univ. and Dr. Garnett Hill, Oklahoma State Univ. will present a 
course in Fall of 1977 at several locations. Course is based on KIM-1 hardware together with 
instruction in Digital Devices, Programing Fundamentals, Advanced Programing, Peripher- 
als, 1/0 addressing, applications, etc. Cost about $600 including a KIM-1 to keep after the 
course. 

115. Gregson, Wilfred J. II,"RTTY with the KIM" 73 Magazine 9, No. 204, p. 110-112 (Sept 1977) 

A clever program for using KIM-1 and the 6-digit LED display as a readout for a RTTY 
signal. Simply feed the audio from a receiver into the tape input of KIM-1 and read the 
message as it flows across the display (about 45.5 baud, 60 wpm). Can also handle other 
ratio to 100 baud). Can also use KIM-1 as a display only, operating from an already avail- 
able terminal unit. 

116. Synertek 3050 Coronado Drive, Santa Clara, CA 95051 Misc. Data Sheets received by mail. 

Describes second source of 6502 and associated microprocessor chips by Synertek. SY6502 
is updated to include ROR function. Other chips include SY6530, SY6522 (PIA), SY6532, 
SY6520, etc. 

117. Rockwell International, 3310 Miraloma Ave., P.O. Box 3669, Anaheim, CA 92803 Data Sheets 
D39 thru D44 received by mail. 

Describes Rockville R6502 microprocessor and other second source Microprocessor acces- 
sory chips including R650X, R651X, R6520 (PIA) R6530 (ROM, RAM, 1/0, Timer) 
R6532, etc. R6502 also available in 2 MHz option. R6502 has the updated ROR function. 

118. Bumgarner, John O., "A-KIM-1 Sidereal/Solar Clock" Interface Age 2, No. 9, p. 36-37 (Aug 
1977) 

119. Atkins, R. Travis, "A New Dress for KIM" Byte 2, No. 9, p. 26-27 (Sept 1977) 

Describes mounting the KIM-1 in a briefcase together with power supply, prototype boards, 
etc. 

120. Chamberlin, Hal, "A Sampling of Techniques for Computer Performance of Music" Byte 2, 
No. 9, p. 62-83 (Sept 1977) 

General Discussion of Music Generation plus detailed information on application to KIM-1 
and a description of the hardware and software for a D/A music board and software package 
being marketed by Micro Technology Unlimited, 29 Mead St., Manchester, NJ 03104. PC 
board alone is $6.00, assembled and tested D/A board $35.00, software package on KIM 
cassette is $13.00 additional. 

121. Beals, Gene, P.O. Box 371, Montgomery ville, PA 18936, "User Group for the Commodore 
PET 2001 Computer" Ref: On Line 2, No. 11, p. 2 (Aug 24, 1977) 

Yearly membership $5.00 brings Users Notes publication. 

122. Cater, J., 11620 Whisper Trail, San Antonio TX 78230, "Run OSI 6502 8K Basic on your TIM 
or JOLT" On Line 2, No. 11, p. 3 (Aug 24, 1977) 

Cost $4.00 for annotated source and object code of patches for TIM or JOLT." 

123. Firth, Mike, 104 N. St. Mary, Dallas, Texas 75214, "Large Type Summary of Command Coder 
for 6502 plus addresses." On Line 2, No. ll,*p. 8 (Aug 24, 1977) Cost: $0.13 stamp plus 
SASE. 

124. House, Gil, P.O. Box 158, Clarksburg, Md., 20734, "6502 Legible Tape Labeler." On Line 2, 
No. 11, p. 9 (Aug 24, 1977) 

A program for TIM (JOLT DEMON), Hex tape and documentation $4.00 

125. Kushe, Willi, "KIM-1 Breakpoint Routines Plain and Fancy" DDJ 2, No. 6, pp. 25-26 (June- 
July 1977) 

A modified routine using KIM-1 Monitor allows size to be cut to only 124 Bytes. 

126. F and D Associates, Box 183, New Plymouth, OH 45654 On Line 2, No. 9, p. 9 (July 13, 1977) 

New product Announcement: Video Display Board compatible with 6502. Two pages 16 
lines x 64 characters, scrolling, screen erase. Bare Board $29 incl. software and documenta- 
tion. 

127. Staff Article "PET Computer" Peoples Computers 6, No. 2, p. 22-27 (Sept-Oct. 1977) 

Chuck Peddle, father of the PET is interviewed. Interesting comments on the marketing of 
this 6502 based microcomputer and accessories. 

128. Inman, Don, "The Data Handler Users Manual: Part 5" Peoples Computers 6, No. 2, pp. 50-55 
(Sept-Oct. 1977) 

Covers Session VII — Writing Programs 
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129. Torzewski, Joe, "Apple I Library" On_Line 2. No. 12 p. 11 (Sept 14, 1977) 

Apple I owners interested in a library for software and hardware should 
contact Joe Torzewski, 51625 Chestnut Rd., Granger IN 46530. 

130. House, Gil, P.O. Box 158, Clarksburg, MO 20734, "6502 Tape Labeler" 
OnJLine 2 No. 12 p. 11 (Sept 14, 1977) 

Man readable 6502 legible tape labeler for TIM, JOLT, DEMON 

131. Cater, J., 11620 Whisper Trail, San Antonio, TX 78230, "Run 0SI 6502 8K 
BASIC on your Tim or Jolt" On_Line £ No. 11, p. 13 (Sept 14, 1977) 

Full info and patches to run this super fast BASIC. 

132. Staff Article "The PET Computer" Personal Computing 1 No. 5, pp 30-40 
(Sept-Oct, 1977) 

Interviews with Chuck Peddle of Commodore and with other micro- 
computer experts. 

133. Lancaster, Don, "Hex-to-ASCII Converter for your TVT-6" Popular Electronics 
AZ No. 4, pp 49-52 (Oct. 1977) 

Simple module produces op-code display for entire computer. Describes 
a board to be connected between the TVT-6 and the KIM-1 microcomputer. 

134. Microcomputer Associates Inc., 2368-C Walsh Ave., Santa Clara, CA 95050 
Popular Electronics 12 No. 4, p. 100 (Oct, 1977) 

New Product Announcement: A 6502 RAP, resident assembler program and 
TINY BASIC of ROM. Cost $200. 

135. CGRS Microtech, P.O. Box 368, Southampton PA 18966, On_Line 2. No. 13, p 2 
(Oct 5, 1977) 

New Product Announcement: EXOS and DATE are two new 6502 software 
packages. EXOS is an Extended Operating System featuring a number 
of useful commands and DATE is a disassembler, assembler, trace and 
debug editor. Available on four programmed 2708 EPROMS or on TIM 
format paper tape. Programs are each $150 or $295 for both, on EPROMS. 

136. Pyramid Data Systems, 6 Terrace Ave., New Egypt, NJ 08533, On_Line £ No 13, 
p 6 (Oct 5, 1977) 

New Product Announcement: XIM is a 1K software package for KIM that adds 
17 commands to the KIM Monitor, including a Breakpoint routine. Cas- 
sette and 45 page manual is $12 ppd., paper tape is $10. 

137. K L Power Supplies, P.O. Box 86, Montgomeryville, PA 18936, 0n_Line 2, 
No. 13, p. 11 (Oct 5, 1977) 

New Product Announcement: Model 512 Power Supply is for the KIM with 
enough capacity for an extra 8K and other accessories. 

138. Matthews, K. , "6502 Forum" Kilobaud No. 10, p 11, (Oct. 1977) 

Mentions E.C.D. Micromind II based on the 6512 A (related to 6502). 

139. Rugg, Tom and Feldman, Phil, "BASIC Timing Comparisons" Kilobaud No. 10 
p. 20 (Oct, 1977) 

Compares over 30 different hobby computer systems on seven different 
Benchmark programs in BASIC. Fastest was 0SI 8K BASIC using 6502 in 
a Challenger running at 2 MHz. Actually a late entry which was still 
a little faster was the HeathKit H-11 with a special Extended Instruc- 
tion Set and a Floating Instruction Set which are to be offered as 
accessories for the H-11. 

160 



140. Overstreet, Jim, "Try Your KIM-1 on RTTY" 73 Magazine No. 205 pp 88-91 
(Oct, 1977) 

Has a Baudot Receive Program that takes the output from an FSK con- 
verter and runs a video terminal with the KIM board. A CW trans- 
mit program is also given in the article. 

141. Schawlow, Arthur L., "Search Subroutine for the 6502 Disassembler", 
Interface Age 2. No. 1, p 146 (Oct, 1977) 

A description, listing and sample run of an object code search sub- 
routine for use with the 6502 Disassembler published in the September 
1976 issue of Interface Age. 

142. Simonton, John S. , Jr., "What the Computer does ... an Introduction.", 
Polyphony 1, No. 1, pp 5-7, 28 (July, 1977) 

PAIA Electronics will shortly have a complete KIM-1 package showing 
how to interface with their 8700 Computer Controller based on a 
6503 processor. A large selection of programs for KIM is promised. 

143. Simpson, Rick, "KIM Forum", Kilobaud No. 11, pp 16-17, 48 (Nov, 1977) 

Caxton Foster of the Computer Sciences Dept. of the University of 
Massachusetts is the author of a college text on microprocessors and 
all programming examples use KIM-1. Also R.W. Burhans, E.E. Dept. of 
Ohio University has some informative comments on the adjustment of 
the PLL pot VR-1. 

144. Butterfield, Jim, "Hyper about Slow Load Times", Kilobaud No 11, pp 66-69 
(Nov, 1977) 

Butterfield explains the development of his HYPERTAPE (Supertape) 
program for loading or dumping to a KIM audio cassette at 50 bytes per 
second, six times the normal KIM-1 rate. 

145. Blankenship, John, "Expand Your KIM", Kilobaud No 11, pp 84-87 (Nov 1977) 

The first of several articles on expanding KIM to use the S-100 bus to 
give 13K memory, Cromenco Dazzler, a printer and keyboard, joysticks, etc. 

146. Johnson Computer, P.O. Box 523, Medina, OH 44256, 0n_Line 2,, No 14, p 7 
(October 26, 1977) 

New Product Announcement: KIM-1 8K Basic by Microsoft is available in 
either a 6-digit or 9-digit precision version which includes full 
printout of error messages. Prices are $97.50 and $129.00. 

147. Rockwell International, P.O. Box 3669, Anaheim, CA 92803, Product Bulletin 

Rockwell now has available a number of 6500 family microprocessor chips 
including r6502, r6505 and others. They also are promoting SYSTEM 65, 
a floppy disc based powerful development system. 

148. Sneed, James R., "Adding an Interrupt Driven Real Time Clock", Byte 2 
No. 11, pp 72-74 (Nov, 1977) 

An external board drives interrupts at 15 Hz which is used to 
calculate time for use by the computer. 

149. Brader, David, "A 6502 Personal System Design: KOMPUUTAR", Byte 2. No. 11 
pp 94-137 (Nov, 1977) 

A very detailed constructional article. 

150. NCE/CompuMart, 1250 N. Main St., Ann Arbor, MI 48104, Byte 2 No. 11, 
p 140, (Nov, 1977) 

New Product Announcement: A number of Accessories for the KIM-1 
including backplane/ S-100 adapter, 8K Seals memory, Poly Video term- 
inal interface, Itty Bitty Tiny BASIC, Matrox Video RAMS, Graphics 
and Alpha-Numerics Boards. 

151. The Enclosures Group, 55 Stevenson St., San Francisco, CA 94105, Byte 2. 
No. 11, p 234 (Nov, 1977) 

New Product Announcement: Offers an enclosure to dress up the KIM-1. 
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152. Apple Computer Inc., 20863 Stevens Creek Blvd., Cupertino, CA 95014 Bvte 
2, No. 11, p 252 (Nov, 1977) 

Apple II is a new entry in the home computer market. At $1298 it 
offers 6K Basic in ROM video graphics in 15 colors, 4K of program- 
mable memory in RAM, a 2K monitor, cassette interface, floating point 
package, etc. 
153 Anon., "Get the most out of Basic", OSI Small Systems Journal 1, No. 2 
PP 4-7 (Sept, 1977) 

Note on Basic in general and the OS-65D System. 

154. Smith, Gary A., "Contributed Program", OSI Small Systems Journal 1, No. 2 
p. 12 (Sept, 1977) 

Program displays the memory address and the data contained in HEX. 

155. Anon., "OSI 6502 Cycle Time Test", OSI Small Systems Journal 1, No. 2, 
pp 12-13 (Sept., 1977) 

Measures the cycle time using a stop watch and program to record the 
number of whole cycles. 

156. Anon., "Memory Test", OSI Small Systems Journal 1, No. 2,pp15-17(Sept 1977) 

A memory test for video and serial- based computers using the 6502. 

157. Anon., "1K Corner: Close the Window", OSI Small Systems Journal 1, No. 2, 
p 18 (Sept., 1977) 

Close the Window is a dice game designed to be played on the OSI 
65V Computers. 

158. The COMPUTERIST, P.O. Box 3, South Chelmsford, MA 01824 

MICRO is a new bimonthly publication specializing in information 
related to 6502 processor based systems. 

159. Salzsieder, Byron, "Cheap Memory for the KIM-1", MICRO No. 1 pp 3-4, 
Oct. -Nov., 1977) 

You can add a Veras Systems 4K Byte memory board to your KIM-1 at 
half the price of the KIM-2. 

160. Holt, Oliver, "Terminal Interface Monitor (TIM) for the 6502", MICRO No. 1 
pp 1-7 (Oct. -Nov., 1977) 

TIM is available on a M0S Technology ROM 6530. 

161. Anon., "We're No. 1", MICRO, No. 1, p 6 (Oct-Nov, 1977) 

An editorial points out that over 12,000 KIM-1 units are in the field 
and a thousand more each month are being ordered. Apple I and Apple II 
systems, plus the OSI units, Jolts, Data Handlers, and other 6502 based 
systems, plus the huge number of PETs and Microminds that have been 
ordered, plus a lot of home-brew systems, it all adds up to a lot of 
6502 systems. Also Atari has purchased one and one-half million 650X 
chips for their game units. 

162. Ferruzzi, Arthur, "Inside the Apple II", MICRO, No. 1, pp 9-10 (Oct-Nov 1977) 

A detailed description of the Apple II. 

163. Ferruzzi, Arthur, "Rockwell International and the 6502", MICRO, No. 1, 
p 10, (Oct. -Nov., 1977) 

Rockwell is now second sourcing the entire 6502 product line. They have 
also developed SYSTEM 65, a fancy development system with dual mini 
floppies, 16K static RAM, text editor, assembler and debug monitor on 
ROM, serial and parallel interfaces for terminal and printer, hardware 
breakpoint, etc. 

164. Floto, Charles, "The PET's IEEE-488 Bus: Blessing or Curse?", MICRO, No. 1, 
p 11 (Oct. -Nov, 1977) 

Discussion of this feature mentions a rumor that Pickles and Trout may 
offer a 488 adapter for their new S-100 1/0 board, as well as an 1/0 
board for the 488 bus. 
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165. Anon., "6502 Related Companies", MICRO, No. 1, p12 (Oct. -Nov., 1977) 

Lists 28 companies serving 6502 processors. 

166. Tripp, Robert M. , "Hypertape and Ultratape", MICRO, No. 1, pp13-l6, 
(Oct. -Nov., 1977) 

Ultratape runs at 12 times the normal KIM-1 speed, but requires special 
programs for both loading and dumping. 

167. Rowe, Mike, "KIM-Based Degree Day Dispatcher", MICRO, No. 1, pp 17-18, 
(Oct. -Nov., 1977) 

Hundley Controls of Hanover, Mass. is building a number of different 
KIM-based systems to be used by fuel oil dealers to perform a variety 
of functions such as meter ticket reading, basic accounting, calcu- 
lating degree- days by measuring temperature and determining when oil 
deliveries are to be made, etc. 

168. Tripp, Robert M. , "Computer Controlled Relays", MICRO, No. 1 p 19 
(Oct. -Nov., 1977) 

Relays can be used for control of audio assettes, and a variety of 
other functions. A 7404 Hex Inverter is used to buffer the signals 
from the KIM's 6530 Port B I/O lines. 

169. Dial, William R., "6502 Bibliography", MICRO, No. 1, pp 21-27, (Oct. - 
Nov., 1977) 

128 references to 6502 related articles, programs, etc. 

170. Camus, Armand L., "Making Music with the KIM-1", MICRO, No. 2, pp 3-7, 
(Dec. 1977-Jan. 1978) 

How to write music for a DAC such as that recently described by 
Chamberlain in Byte Magazine, Sept. 1977. 

171. Floto, Charles, "Meet the PET", MICRO, No. 2, pp 9-10 (Dec 1977-Jan 1978) 

An owners view of the PET 2001. 

172. Dejong, Marvin L., "Digital-Analog and Analog-Digital Conversion Using 
the KIM-1", MICRO, No 2, pp 11-15, (Dec. 1977-Jan 1978) 

Experiments with a KIM-1 controlled DAC/ADC. 
173 Wallace, Bob, "The PET Vs. the TRS-80", MICRO No. 2, pp 17-18, 
(Dec. 1977 - Jan 1978) 

A feature-by- feature comparison. 

174. Schwartz, Marc, "Ludwig von Apple II", MICRO, No. 2, p 19 (Dec 77- Jan 78). 

How to write music for the Apple II. 

175. Anon., "MICROBES - Tiny Bugs in Previous MICRO", MICRO, No. 2, p 22, 
(Dec. 1977 - Jan. 1978). 

Some corrections for HYPERTAPE and ULTRATAPE and Computer Controlled 
Relays. 

176. Henkel, Joel, "The Challenge of the OSI Challenger", MICRO, No. 2, 
pp 23-24 (Dec 1977 - Jan 1978) 

An owners impressions of the OSI Challenger. 

177. MOS Technology, "Improving Keyboard Reliability", MICRO, No. 2, p 25, 
(Dec 1977 - Jan 1978) 

A hardware modification for your KIM-1 to improve action of the "9, D, 
or C" keys. Based on an Application Note by MOS Technology. 

178. Dial, William, "Important Addresses of KIM-1 and Monitor", MICRO, No. 2, 
pp 27-30, (Dec 1977 - Jan 1978) 

A programmers reference card for the KIM-1 . 

179. Computer Shop, 288 Norfolk St., Cambridge, MA 02139, MICRO, No. 2, 
p 26, (Dec. 1977 - Jan. 1978) 

Advertisement for CS 100 Video Terminal Board for KIM. Includes 

portable cabinet for the KIM with space for cassette recorder, ASCII 

keyboard, power supply, extra memory boards, 3-slot motherboard, 

TIM kit, etc. 
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180. Gordon, H.T., "Decoding 650X Opcodes", Dr. Dobbs Journal 2 No 7 
pp 20-22 (Aug. 1977) 

Subroutines that can be used with KIM. 

181. Butterfield, Jim F. , "A High-Speed Memory Test Program for the 6502" 
DDJ 2, No. 7, P 23 (Aug. 1977) 

A memory test program written for the KIM system. 

182. Anon. "Ohio Scientific's New Disc Operating System", DDJ 2, No 7 
p 32 (Aug. 1977) ~ ' ' 

The OS-65D is a complete operating system for all disc based 0SI computer 
systems. Includes DOS, 8K Basic, Assembler, Editor, Extended Debugger 
and a Disassembler. 

183. Anon.., "0SI offers Computer that thinks in Basic for 4298". DDJ 2 No 7 
P 39 (Aug. 1977) ' 

OSI's new Model 500 CPU board can be used as a stand-alone computer or 
as the PCU in a larger system. 

184. Moser, Carl W. , 3239 Linda Dr., Winston-Salem, NC 27106, DDJ 2, No 8 
p 28 (Sept. 1977) 

Announcement of New Product: $25 for 6502 Editor and Assembler Hex 
Listing and Manual. Configured for TIM Systems. 

185. Anon., "IK Corner", 0SI Small Systems Journal J_, No. 4, p 3 (Oct. 1977) 

Hex address and offset calculator program resides at 0DDE to 0EE4. 

186. Anon., "Now You Can Play Star Wars", OSI Small Systems Journal 1, No 4 
PP 11-13, (Oct. 1977) 

Star Wars program by Robert L. Coppedge requires 8K Basic, OSI 440 
Video Board and at least 4K of RAM. 

187. Anon., "Conventional Typewriter", OSI Small Systems Journal J., No. 4 
pp 8-9 (Oct. 1977) 

Gary Smith's program for using the OSI-65V when interfaced to a printer 
to be used as a conventional typewriter and also modify the text for 
a data file. 
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Gordon, H.T., "0PLEGL Correction and a 6502 Scanning-Debugger", DDJ 2, 
No. 9, PP 42-44 (Oct. 1977) 



Gordon offers a corrected version of his 650X subroutine, 0PLEGL, and 
gives a new byte-count subroutine, NUMBYT. A new scanning-debugger, 
SIMBUG, is submitted. 

189. Swope, J., "6502 Goodies", DDJ 2, No. 9, Issue 19, p 45 (Oct. 1977) 

Swope, President of CGRS Microtech, P0 Box 368, Southampton, PA 18966, 
announces that his company has finished a 6502 computer board for the 
S100 bus. 

190. Wozniak, Stephen, "Sweet 16: The 6502 Dream Machine", Byte Z, No. 11, 
pp 150-159 (Nov. 1977) 

Sweet 16 is a 16 bit "metaprocessor" in software, intended as a 6502 
enhancement package, not a stand-alone processor. 

191. Shattuck, Bob and Schmidt, Bill, "Receive CW with a KIM-1", 73 Magazine, 
No. 206, pp 100-104 (Nov. 1977) 

A program for receiving CW with optional TTY or KIM display. 

192. Johnson, Donald J., "KIM-1 Sidereal/Solar Clock Correction", Interface Age 
Z, No 12, p 9 (Nov. 1977) 
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A correction in the listing given in the August issue of Interface Age 
permits 24-hour operation. 

193. KL Power Supplies, PO Box 86, Montgomeryvi] le, PA 18936, Interface Age 2, N 
No. 12, p 140 (Nov. 1977) 

The Model 512, 4.5 amp. power supply is designed for KIM-1 . 

194. Micro Technology Unlimited, Box 4596, Manchester, NH 03108, Interface Age 2, 
No. 12, p 140 (Nov. 1977) 

The MTU Model K-1000 power supply is designed to power the KIM-1. 

195. Wasson, Philip A., "Trace", KIM-1/6502 User Notes, Issue 7/8, pp 2-3 
(Sept & Nov 1977) 

With this program and about $2.00 worth of hardware you can see dis- 
played on an oscilloscope screen, all of the registers in the 6502 
and three consecutive memory locations. 

196. Ohsiek, Charles C. , "ID on Audio Cassette for SUPERTAPE", User Notes, 
Issue 7/8, p 4 (Sept & Nov 1977) 

Program allows writing an ID on the audio cassette tape prefixing the 
data SUPERTAPE writes out. 

197. Hawkins, George W. , "2-Task Alternating Scheduler Routine", User Notes, 
Issue 7/8, p 5 (Sept & Nov 1977) 

Program allows two programs to be run together in the KIM-1 . 

198. Gordon, Hal, "A Catalog of KIM-1 ROM Bytes", User Notes, Issue 7/8, p 5, 
(Sept. & Nov. 1977) 

A table of the location of ROM bytes. 

199. Anway, Allen, "Program BRANCH", User Notes, Issue 7/8, p 6 (Sept & Nov 1977) 

With this program you can go through your program, find the Branch in- 
structions and force the branch to see where you will end up. 

200. Pollock, Jim, "KIM-1 to S-100 Bus Adapter", User Notes, Issue 7/8, 
p 7 (Sept. & Nov. 1977) 

This adapter allows KIM-1 to be used with S-100 boards such as the $125 
8K RAM board of Ithaca Audio. 

201. Heinz, Harvey, "A Simple Music Program for KIM", User Notes, Issue 7/8, 
pp 8-9 (Sept. & Nov. 1977) 

This is an excellent tutorial program with basic level explanations. 

202. Hapgood, Will, "An A/D Converter", User Notes, Issue 7/8, pp 10-11, 
(Sept. & Nov. 1977) 

A circuit for making very accurate A/D conversions using a Motorola 
dual-slope conversion chip, MC 1405 or 1505. 

203. Butterfield, Jim, "KIM Blackjack", User Notes, Issue 7/8, pp 11-13, 
(Sept. & Nov. 1977) 

Game uses the KIM display to good advantage in this program. 

204. Strandtoft, B. , "KIM-1 Resident Programs and Subroutines", User Notes, 
Issue 7/8, p 14 (Sept. & Nov. 1977) 

A list of KIM Monitor routines with brief explanations. 

205. Goenner, Markus P., "TTY Rapid Load", User Notes, Issue 7/8, p 15, 
(Sept. & Nov. 1977) 

Program starts at 0000 and is fully relocatable. 

206. Parson, Charles H. , "Read Temperature Once per Minute", User Notes, 
Issue 7/8, pp 16-18, (Sept. & Nov. 1977) 

Program for temperature control systems. 

207. Oliver, John and Hall, Williamson, "A KIM-1 Binary Dump and Load Routine", 
User Notes, Issue 7/8, pp 19-20, ( Sept. & Nov. 1977) 

SUPERDUMP/SUPERLOAD allows the use of the KIM-1 Cassette tape interface 
to read and write data blocks under program control. 1K bytes are 
dumped or loaded in less than 12 seconds. 
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208. The COMPUTERIST, PO Box 3, S Chelmsford, MA 01824, "MEMORY PLUS for KIM-1" 
New Product Announcement, MICRO, No. 2, p 2 ( Dee 1977- Jan 1978) 

New board for fitting directly beneath the KIM-1 has 8K RAM, 8K EPROM 
MOS Technology Versatile Interface Adapter, EPROM programmer, On Board 
Voltage Regulators; fully assembled and tested $245; Intel 2716 2K EPROM"* 
extra $50 each. 

209. Cole, Phyllis, "PET Update", Peoples Computers £, No. 3, PP 6-7 (Nov-Dec1977) 

Several rumors on the PET are answered. 

210. Cole, Phyllis, "Our PET's First Steps", Peoples Computers £, No. 3, pp 8-10 
(Nov-Dec 1977) 

An account of bringing a PET on stream in spite of a few initial bugs 
and limited documentation at the time. 

211. Inman, Don, "The Data Handler Users Manual: Part 6", Peoples Computers 6 
No. 3, PP 11-15, 44 (Nov-Dec1977) 

The latest contribution, in this series covers multiplication and 
division programs. 

212. The 6502 Program Exchange, 2920 Moana, Reno, NV 89509, "Software Announce- 
ment:, On Line £, No. 15, p 7 (Nov. 16, 1977) 

Recent software includes an extended version of FOCAL, a 4K resident 
assembler and an efficient Mini-Editor. 

213. MSS, Inc., "65XX Programs Available", New product announcement, On Line 2 
No. 17, p 2 (Dec. 30, 1977) 

Programs available include Disassembler, Loader, Punch, Dump, Memory 
Editor, Life Game, File Commands, Assembler/Text Editor, etc, MSS, Inc., 
3201 East Pioneer Parkway, Suite 40, Arlington, Texas 76010. 

214. Rychlewski, Walter J., Ill, "PET Demonstration Tape", On Line 2, No. 17, 
p 7, (Dec. 30, 1977), New Product Announcement. 

Ten BASIC programs demonstrate most of the features of the PET; includes 
graphics and real time clock; $10 cassette. 603 Spruce St., Libertv. 
M0 64068. y ' 

215. Purser, Robert Elliott, P0 Box 446, El Dorado, CA 95623, On Line Z, No. 17, 
p 9 (Dec. 30, 1977), New Product Announcement. 

PET layout sheet with SASE, free. 

216. Anon, "1K Corner: Cassette Loader and Memory Block Transfer", 0SI Small 
Systems Journal 1, No. 5, p 3 (Nov. 1977) 

With this program the user may record his own programs via the 430B Super 
1/0 Board in a format that is recognizable to the auto-load function in 
the 65V Monitor PROM. 

217. Anon, "Two New Software Packages", 0SI Small Systems Journal 1, No. 5, 
pp 4-7 (Nov. 1977) 

OSI has released two major new Disc software packages, Word Processor 
and 9-Digit BASIC which run under OS-65D version 2.0 

218. Anon, "Two New Video Games", OSI Small Systems Journal 1, No. 5, pp 8-12 
(Nov. 1977) 

SAM (Surface-to-Air Missile) and BOMBER require OSI 8K BASIC, OSI 440 
Video Board, terminal and Keyboard, and at least 4K of RAM. 

219. Pfeiffer, Erich A., "Seasons Greetings", OSI Small Systems Journal 1, No. 5, 
p 12 (Nov. 1977) 

Program using PEEK and POKE instruction to present a video message. 

220. Anon, "ASCII Files under OS-65D", OSI Small Systems Journal 1, No. 5, 
pp 13-15 (Nov. 1977) 

Auxilliary assistance program for a file system. 

221. Anon, "BASIC in ROMS", New Product Announcement, OSI Small Systems Journal, 
1, No. 5, P 15 (Nov. 1977) 

The BASIC in ROM set No 65AB including 4 ROMS, one EPROM for the 6502 
system; Another version 65VB for 440 Video system also available. Either 
version is $99- 
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222. Struve, Bill, "A $19 Music Interface", Byte 2, No. 12, pp 48-69, 170-171 
(Dec. 1977) 

Some theory and a KIM-1 interface for computer/music addicts. 

223. Gordon, H.T., "The XF and X7 Instructions of the MOS Technology 6502", 
Byte Magazine £, No. 12, p 72 (Dec. 1977) 

A look at some of the unlisted instructions available in the 6502. 

224. Forethought Products, PO Box 386, Coburg, OR 97401, Kilobaud, No. 12, 
p 15 (Dec. 1977), New Product Announcement. 

A new board that makes S-100 (Altair/Imsai) type boards compatible with 
KIM. Motherboard has 8 slots, and does not alter the operation of 
KIM in any way. 

225. Lancaster, Don, "TVT Hardware Design", Kilobaud, No. 12, pp 30-34 (Dec1977) 

Part 1; instruction decoder and scan. Taken from Lancaster's new book, 
"The Cheap Video Cookbook" on the TVT-6L. 

226. Blankenship, John, "Expand Your KIM!", Kilobaud, No 12, pp 36-42 (Dec 1977) 

Part 2 discusses cabinet, nuts and bolts, in this series. 

227. Byrd, David A., "TVT-6 Display Uncrowding", Popular Electronics 12. , No. 6, 
p 6 (Dec. 1977) 

Gives a technique for correction of a crowding of the display in Lan- 
caster's TVT-6 Video Display. 

228. Pittelkau, Clifton W. , "The Bionic Clock!", 73 Magazine, No. 208, 
pp 102-105 (Jan. 1978)\ 

Software to add a real time clock to your KIM. 

229. Eaton, John, "Growing with KIM", Kilobaud, No. 13, PP 36-39 (Jan. 1978) 

Expansion PC Board provides compatibility with S-100 bus. 

230. Chamberlin, Hal, "Software Keyboard Interface", Kilobaud, No. 13, PP 98- 
105 (Jan. 1978) 

Shows how with a minimum of hardware and minimum cost. 

231. Kraul, Douglas R. , "Designing Multichannel Analog Interfaces", Byte 2, 
No. 2, pp 18-23 (June, 1977) 

Hardware and software for an 8-channel analog I/O. 

232. Fylstra, Dan, "Interfacing the IBM Selectric Keyboard Printer-Teaching KIM 
to Type", Byte 2, No. 6, pp 46-52, 133-139 (June 1977) 

Hardware and software for hooking KIM up to a Selectric. 

233. Jobs, Steven, "Interfacing the Apple Computer", Interface Age J., No. 11, 
pp 65-66 (Oct. 1976) 

Interfacing with a printer. 

234. Wozniak, Steve and Baum, Allen, "A 6502 Disassembler from Apple", DDJ _1, 
No. 8, pp 22-25 (Sept. 1976) 

Displays single or sequential 6502 instructions in mnemonic form. 

235. Grater, Robert, "A Teletype Alternative", Kilobaud, No. 1, pp 114-116 (Jan77) 

Convert parallel input TVT to serial operation, for KIM. 

236. Anon. "Errata to Zieglers 6502 Bug Program", DDJ 1, No. 8, p 33 (Sept. 1976) 

Corrections for the listing given earlier in DDJ ±, No. 3. 

237. Parks, Don, "Adding PLOP to your System", Kilobaud, No. 5, P 98 (May 1977) 

A 6502 noisemaker for computer games. 

238. Rankin, Roy, "Errata for Rankin's 6502 Floating Point Routines", DDJ 1, 
No. 10, p 57 (Nov/Dec, 1976) 

Correction of a bug found in his earlier routine published in DDJ J., No. 7. 

239. Lancaster, Don, "Build the TVT-6, Part II", Popular Electronics 1£, No. 2 
pp 49-55 (August, 1977) 

System debugging, software, and how to interface to KIM and other systems. 
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240. The Data Mart, 914 East Waverly Drive, Arlington Heights, IL 60004, New 
Product Announcement, "Real Time Clock", On Line 2, No. 18, p 11 (Jan 18,1978) 

Real Time Clock and Calendar for 6502. Assembled $95. 

241. Optimal Technology, Inc., Blue Wood 127, Earlysville, VA 22936, Hardware 
Announcement: PROM Programmer, On Line Z, No. 18, p 11 (Jan 18, 1978) 

Programmer for KIM programs both the 2708 and 2716 EPROMS. Runs on all 
650X systems. 

242. Trageser, Jim, "TVT-6L Correction", Kilobaud, No. 12, p 123 (Dec. 1977) 

Corrections for the June 1977 article by Lancaster. 

243. Meyers, Michael J., "Dedicated Controllers - There is Money to be Made" 
Kilobaud, No. 10, pp 84-92 (Oct. 1977) 

Hobbyists should take advantages of opportunities to make money with 
their KIM or other micro. 

244. Burhams, R.W. , "Consider a MITE Printer", Kilobaud, No. 11, pp 38-42 
(Nov. 1977) 

At $276, the Mite Expandor is an alternative to the ASR-33 TTY. 

245. Penhollow, Bert G.H.. "Binary to BCD Conversion for Microprocessors", 
Electronic Design, p 212 (Oct. 11, 1977) 

Packs the units and tens into one byte. 

246. Chamberlain, Hal, "Computer Bits: Computer Music Part II", Popular Elec- 
tronics 10., No. 4, pp 88-91 (Oct. 1977) 

A description of music techniques which have been implemented on the 
KIM-1 DAC board. Also discusses generation of Touch Tone codes. 

247. Chamberlain, Hal, "Computer Bits: Computer Music Part I", Popular Elec- 
tronics 10., No. 3, PP 116-119 (Sept. 1977) 

Timed loop techniques for computer music programs. 

248. Anon., "74 Megabyte Disc Review", OSI Small Systems Journal 1, No. 6, pp 
pp 2-6 (Dec. 1977) 

OSI offers the 74 megabyte CD-74 disc drive for small computers. Has 
four aluminum disc platters about 12" diameter. $6000. 6502 Related. 

249. Anon., "Article Sponsorship Program", OSI Small Systems Journal 1, No. 6, 
p 7 (Dec. 1977) 

OSI will pay for and provide technical assistance for articles on OSI 
equipment or programs to be published in computer magazines. 6502 Related. 

250. Anon., "1K Corner", OSI Small Systems Journal 1, No. 6, p 7 (Dec 1977) 

Short Program for PRIME NUMBER GENERATOR. 

251. Owens, Gerald, "Shoot the Gluck", OSI Small Systems Journal 1, No. 6 
pp 8-10 (Dec. 1977) 

A game for the 12K Challenger with video. 

252. Anon., "Floppy Disk Users Group", OSI Small Systems Journal 1, No. 6 
p 10 (Dec. 1977) 

OSI has formed a users group to redistribute user-contributed software 
on diskettes. The first group of 6502 machine code programs (12 listings) 
is now available. 
253- Anon., "Terminal/Cassette DOS Input Routine", OSI Small Systems Journal 1, 
No. 6 pp 11-12 (Dec. 1977) 

Program for reloading or transferring program source code. 

254. Anon., "New Diskette Software packages", OSI Small Systems Journal 1, No. 6, 
p 12, (Dec. 1977) 

Work Processor WP-1 and WP-1A is a complete word processor. OS-65D Ver- 
sion 2.0 with Nine-digit BASIC. Disk-Test provides a quick functional 
check of the 6502 computer system. 

255. Anon., "Bank Accounts", OSI Small Systems Journal 1, No. 6, pp13-15(Dec 1977) 

Two practical programs: CHECKBOOK ACCOUNT and SAVINGS ACCOUNT. 
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256. Fylstra, Dan, "SWEETS for KIM", Byte 1, No. 2, pp 62-77 (Feb. 1978) 

SWEETS, a .Simple Way to Enter, Edit and Test Software, is a small text 
editor and assembler which operates on hexadecimal code and which is 
designed to fit in the KIM-1's 1K byte small memory while leaving room for 
the user ' s programs . 

257- Feagans, John, "A Slightly Sour SWEET 16", Byte a, No. 2, p 93 (Feb. 1978) 
Correction of a slight bug in the Wozniak article in Byte, Nov. 1977 ♦ 

258. Leasia, John D. , "Random Errors", Byte 3., No. 2, p 93 (Feb. 1978) 

Correction of an error in the pseudorandom number generator shown 
earlier in Byte, Nov. 1977, P 218. 

259- Kathryn Atwood Enterprises, P.O. Box 5203, Orange, CA 92667, Byte 3., No. 2, 
p 187 (Feb. 1978), New Product Announcement 

4K RAM board, KIM interface and Mother Board. 

260. Electronics Warehouse Inc., 1603 Aviation Blvd., Redondo Beach CA 90278, 
New Product Announcement. 

Apple II I/O Board Kit plugs into slot of Apple II Mother Board. 

261. Pittelkau, Clifton W. , "KIM-1 Can Do It!", 73 Magazine, No. 209, PP 68-71 
(Feb. 1978) 

Adapting a KIM-1 to function as a versatile RTTY terminal at nominal cost. 

262. O'Reilly, Francis J., "Looking for a Micro?", 73 Magazine, No. 209, 
PP 76-77, (Feb. 1978) 

Pro's and Con's of the KIM-1 as a micro. 

263. Bridge, Theodore E. , "A KIM-1 Disassembler", DDJ 2, No. 10, Issue 20, 
pp 12-13 (Nov. -Dec. 1977) 

A modification of Wozniak' s earlier 6502 disassembler. 

264. Eaton, John, "MATHPAC: A Kimath Supplement", DDJ Z, No. 10, Issue 20, 
pp 15-21 (Nov. -Dec. 1977) 

MATHPAC is designed to increase the power of a 6502 system. It takes 
the power of KIMATH and gives it to the user. The user's 1/0 ASCII 
device turns the system into a scientific calculator. 

265. Osborne, Adam, "War of the Processors", SCCS Interface J., No. 6, pp 14-17, 
(May, 1976) 

Traces evolution of major microprocessors, including 6502 and compares 
their computing power. 

266. Anon., "KIM-1, A complete Microcomputer System for $245", SCCS Interface J_, 
No. 6, pp 44-45 (May, 1976) 

A new products announcement for KIM-1. 
267- Teener, Mike, "Bits and Byters" , SCCS Interface 1, No. 6, p 58 (May, 1976) 
Historical note recaps Motorola's suit against MOS Technology over 
the 6502 's predecessor. 

268. MOS Technology, Inc., 950 Rittenhouse Road, Norristown, PA 19401, KIM 
Application Note #107702, "S-100 to KIM-4 Bus Adapter", 

Mechanical details of a simple adapter that will plug into the KIM-4 
Mother Board and which will accept certain compatible S-100 boards such 
as the Kent-Moore No. 60083 video display Doard or the Kent-Moore 
No. 60082 4K static RAM board. 

269. MOS Technology, Inc., 950 Rittenhouse Road, Norristown, PA 19401, KIM 
Application Note #111477, "Using KIM as a Dedicated Controller" 

The KIM itself can be used as a very low cost controller with the addition 
of a PROM, a power-on-reset modification, and some additional circuitry 
to transfer control to the added PROM upon power-up. 

270. MOS Technology, Inc., 950 Rittenhouse Road, Norristown PA 19401, KIM 
Application Note #117701, "Digital-Analog and Analog-Digital Conversion 
Using the KIM-1" 

This is essentially the same as Reference #172 on De Jong's article in 
MICRO No. 2. Uses a 1*408 D/A converter with KIM together with hardware 
and software for D-A and A-D as well as software to store the A/D con- 
verter output and recall converted data, emulating a storage oscilloscope. 
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271. MOS Technology, Inc., 950 Rittenhouse Road, Norristown, PA 19401, KIM 
Application Note #771121, "Software Routines for TVT" 

Machine Language program to use with external keyboard. 

272. Optimal Technology, Inc., Blue Wood 127, Earlysville,VA 22936, On Line 3., 
No. 1, p 1 (Feb. 8, 1978). New Product Announcement. 

2708/16 EPROM PROGRAMMER for KIM-1. Requires 1-1/2 I/O Ports. 
Assembled and tested $59.95. Kit $49.95. 
273- Purser, POB 466, El Dorado, CA 95623, On Line 2, No.1, p 3 (Feb. 8, 1978) 
Free Guidelines for writing programs for the TRS-80 and PET and then 
selling them to Radio Shack and Commodore. Send SASE. 

274. Personal Software, P.O. Box 136-03, Cambridge MA 02138 
On-Line 3, No 1 pg 4 (Feb. 8, 1987) New Product Announcement. 

Four full length games on cassette for PET or TRS-80. 
POKER, ONE QUEEN, KINGDOM, MATADOR; $9-95 for all four. STIMULATING 
SIMULATIONS by Dr. C.W. Engel , and additional entertainment personal 
finance/investment, and other systems programs including a 6502 
Assembler in BASIC. 

275. 6502 Program Exchange, 2920 Moana, Reno, NV 89509, Kilobaud, p 7 (Mar. 1978) 

Announcement of new 6502 Software including an extended version of 
FOCAL called FCL 65E (6.5K). Also a Mini-Manual to get you started 
on TIM or KIM systems. 

276. Eaton, John, "Corrections", Kilobaud, No. 15, p 12 (March, 1978) 

Note on tne availability of drilled PC boards for Eatons' KIM expansion 
article in January 1978 Kilobaud. 

277. Scogin, Tom, "AppleSOFT Benchmarks: Fast!", Kilobaud, No. 15, p 12 (Mar 78) 

Gives times for seven benchmark programs using Apple-II Integer and 
Apple-II AppleSOFT versions of BASIC. 

278. Blankenship, John, "Expand Your KIM!", Part 4., Kilobaud, No. 15, 
pp 84-88 (March, 1978) 

Part four of this series uses a $10 circuit board with a SWTP keyboard 
and a PR-40 printer as a miniature teletype. 

279. Zaks, Rodney, "Micro History", Personal Computing 2, No. 2, pp 31-35, 
(Feb., 1978) 

History of microprocessors. Has a very small paragraph on the MOS 
Technology 650X family. 

280. DeJong, Marvin L. , "Employing the KIM-1 Microcomputer as a Timer and Data 
Logging Module", MICRO No. 3, PP 3-7 (Feb. - Mar., 1978) 

System for logging the time of up to 75 events to the nearest 100 micro- 
seconds or to other time increments, and later displaying these times on 
the KIM-1 display. 

281. Carpenter, C.R., "Machine Language used in ' Ludwig von Apple II'", MICRO, 
No. 3, P 8 (Feb. - Mar. 1978) 

Notes on an assembled version of the machine language used by 
Schwartz, MICRO, No. 2, p 19 in his music program. 

282. Carpenter, C.R., "Printing with the Apple II", MICRO, No. 3, PP13-16, 
(Feb-Mar, 1978) 

Hard-copy output from the Apple II using a TELPAR thermal printer, a simple 
one- transistor adapter circuit and a machine language printing routine. 

283. Foreman, Evan H. , P.O. Drawer F, Mobile, AL 36601, "The PET Shop", MICRO, 
No. 3, P 10 (Feb. - Mar. 1978) 

Foreman offers to trade five game programs for the PET on a one-for-one 
basis. 

284. Floto, Charles, "The PET VET Tackles Data Files", MICRO, No. 3, PP 9-10, 
(Feb. - Mar. 1978) 

Discusses problems some have encountered in recording data files on tape 
and reading the information back in. Floto, in his capacity as the PET 
VET, offers his services on problems met with specific applications of PET. 
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285. Tater, Gary L., "Hold That Data", MICRO, No. 3, P 11 (Feb. - Mar. 1978) 

Program to stop data on the video terminal by pressing a key. Handy 
for examining data during a disassembly or a long directory program. 

286. Tripp, Robert M. , "Typesetting on a 6502 System", MICRO, No. 3, pp 19-24, 
(Feb. -Mar. 1978) 

A program for "justification" of copy to be printed. 

287. Tater, Gary L. , "TIM Meets the S100 Bus", MICRO, No. 3, PP 25-26 
(Feb. -Mar. 1978) 

A bare-bones TIM S100 board to use with a terminal such as the CT-64 
from SWTP. 

288. Holt, Rod, "The Apple II Power Supply Revisited", MICRO, No. 3, p 28 
(Feb. -Mar. 1978) 

It is pointed out that the Apple II power supply, although small in 
physical size, is a switching type which runs cool and is sufficient 
to run an Apple II with several extra cards plugged into the system. 

289. Anon, "Microbes-Tiny Bugs in Previous Micros", MICRO, No. 3, p 28 (Feb-Mar) 

Corrections for Ultratape, MICRO No. 1, p 13; Making Music with the KIM, 
MICRO No. 2, p 7; and Important Addresses of KIM-1, MICRO No. 2, p 30. 

290. Husbands, Charles R., "A Simple Frequency Counter Using the KIM-1", MICRO 
No. 3, PP 29-32 (Feb. -Mar. 1978) 

The use of KIM-1 as a counter operating over the range of 500 Hz to 
above 15KHz. 

291. Dial, William, "6502 Bibliography-Part II", MICRO, No. 3, PP 33-36 (Feb-Mar) 

The second" segment of this bibliography covers references 129 to 179 of 
the rapidly growing 6502 literature. 

292. DeJong, Marvin L. , "Lighting the KIM-1 Display", MICRO, No. 3, Back Cover. 

Information on how to use the KIM-1 seven-segment display. 

293. Anon, "Software Sources: 6502 Executive for KIM-1", Popular Electronics 13 

No. 3, P 98 (March 1978) 

Adaptable to any 6502 system, this Executive is designed for KIM-1 with 4K 
or more and TTY or TVT interface. $25 for listing. From Innovative 
Software, Inc., 3007 Casa Bonita Dr., Bonita, CA 92002. 

294. Pollock, James W. , "Microprocessors: A Microprocessor controlled CW Keyboard" 
Ham Radio 11, No. 1, pp 81-87 (Jan. 1978) 

A preprogrammed microcomputer is designed to function as a Morse Code 
keyboard. Uses a M0S Technology MCS6504 which is a software compatible 
cousin to the 6502. 

295. Connecticut Microcomputer, 150 Pocono Rd., Brookfield, CT 06804, New 
Product Announcement, "RS-232 Adapter for KIM", DDJ 3., No. 21 , p 3 (Jan '78) 

The ADApter converts KIM's 20 ma. current loop port to an RS-232 port 
without affecting the baud rate. $24.50 

296. Schick, Paul, "Unsupported OPCODE Pitfalls", DDJ 3, No. 21 , p 3 (Jan 1978) 

Comments on the earlier article on 650X Opcodes: DDJ, Aug 1977. 

297. Moser, Carl, "Memory Test for 6502", DDJ 3, No. 21, pp 4-5, (Jan 1978) 

A program which tests RAM memory in a 6502 based system. I/O is arranged 
for 6502 TIM based system but can be easily changed. 

298. Smith, Stephen P., "Challenging Challenger's ROMS", DDJ 2, No. 21, p 6 (Jan) 

Using the PREK function of the 0SI Microsoft BASIC, a disassembler to 
convert stored bytes in the PROMs or ROMs has been devised. 

299. Computers One, PO Box 7148, Honolulu, HI 96821, New Product Announcement, 
On Line 3, No. 2, p 4 (March 1, 1978) 

Pre-recorded programs for PET. "HUSTLERS" includes a number of business 
oriented programs for checking accounts, rent accounts, legal dairy and 
trust accounts. 

300. Lufkin, C.R., 315 Dominion Dr., Newport News, VA 23602, On-Line _3_, No 2, 
p 5 (March 1, 1978) 

FITABP is Federal Income Tax Program for PET owners with 8K. Prints 
out form 1040 Schedule A and B. 
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6502 BIBLIOGRAPHY 

PART IV 

William Dial 

438 Roslyn Avenue 

Akron, OH 44320 

301. Michels, Richard E. "How to Buy an Apartment Building", Interface Age _3_, 

No. 1, pp 94-99 (Jan 1978) 

A 6502 FOCAL based system for handling the many factors involved via 

a computer decision making program. 

302. Woods, Larry "How Are You Feeling Today?" Kilobaud No. l4,pp24-30(Feb 1978) 

Biorhythms with your KIM are displayed on the KIM readout. 

303. Craig, John "Editor's Remarks" Kilobaud No. 14 p 22 (Feb 1978) 

In a discussion of Microsoft Level II BASIC it is pointed out that Micro- 
soft BASIC is being used on Altair 6800 and 8080, TRS-80, and 6502 based 
systems OSI, PET> KIM and Apple (floating-point version). 

304. Bishop, Robert J. "Star Wars" Kilobaud No. 14 pp52-56 (Feb. 1978) 

An Apple-II graphics game based on the 6502. 

305. Blankenship, John "Expand Your KIM! Part 3" Kilobaud pp68-71 (Feb. 1978) 

This installment covers bus control board and memory. 

306. Burhans, R.W. "How Much Memory for a KIM?" Kilobaud p 118 (Feb. 1978) 

Decoding the KIM for 28K. 
307- Pearce, Craig A., p. 6 suggestions for running graphics on the PET. 
Julin, George, pp6-7, letter on PET graphics. 
Stuck, H.L. p 7, more on the PET. 

Above three are letters in Peoples Computers j>, No. 4, (Jan-Feb. 1978) 

308. Wells, Edna H. "Program Abstract" Peoples Computers p 7 (Jan-Feb. 1978) 

Program for the Commodore PET with 8K BASIC, entitled Graphics-to ASCII 
Utility—ASCIIGRAPH. 

309. Cole, Phyllis "SPOT- The Society of PET Owners and Trainers", Peoples 
Computers No. 4, pp 16-19 (Jan-Feb 1978) 

Notes for the Users of the PET. 

310. Inman, Don "The Data Handler User's Manual: Conclusion" Peoples Computers 
No. 4 pp24-31 (Jan-Feb 1978) 

The final installment of this series covers simple and inexpensive 
output devices. 

311. Inman, Don "The First Book of KIM, Peoples Computers No. 4 p34 (Jan-Feb1978) 

A good review of this excellent book. 

312. Braun, Ludwig "Magic for Educators — Microcomputers" Personal Computing, 2. 
No. 1, pp 30-40 (Jan. 1978) 

Discussion of micros includes the 6502 based Apple II and the PET. 

313. Helmers, Carl "An Apple to Byte", BYTE 2, No. 3, P. 18-46 (Mar. 1978) 

A user's reactions to the Apple II, with an example of a simple 
"color sketchboard" application. 

314. Fylstra, Dan "User's Report: The PET 2001", BYTE, pp 114-127 (Mar. 1978) 

A fairly comprehensive report on the PET. 

315. Brader, David, "KOMPUUTAR Updates", BYTE pp131-132 (Mar. 1978) 

In a letter Brader responds to some inquiries on his KOMPUUTAR system 
based on 6502 which was published in BYTE, Nov. 1977. 

316. Jennings, Peter R. , "Microchess 1.5 versus Dark Horse", BYTE J., No. 3 
pp 166-167 (March 1978) 

Microchess 1.5 is Jenning's new extended version of the original Micro- 
chess. It occupies 2.5K and runs on KIM-1 with expanded memory. It is 
still being developed but in a test game with Dark Horse, a 24K program 
written in Fortran IV, the new version did very well indeed. 
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317. Rindsberg, Don "Here's HUEY! .. .super calculator for the 6502", Kilobaud, 
No. 12, pp 94-99 (December 1977) 

The calculating power of FORTRAN with trig functions, natural and 
common logs, exponential functions, all in 2.5K. 

318. Finkel, LeRoy "Every Home (School) Should Have a PET" 
Calculators/Computers, page 83 (October 1977) 

319. Anon, "12-Test Benchmark Study Results Show How Microprocessors Stack Up 
(8080, 6800, 6502)", EDN, page 19 (November 20, 1977) 

320. Gordon, H.T. "Decoding Efficiency and Speed", DDJ 3., Issue 2, No. 22, 
PP 5-7 (Feb., 1978) 

Pros and cons of table look-up in 650X microprocessors. 

321. Green, Wayne "Publishers Remarks", Kilobaud, No. 16, p 4 (April 1978) 

In a column on microprocessors, Green indicates that MOS Technology has 
a SuperKIM being readied and also that books on expanding the KIM system 
are coming out. 

322. Carpenter, Chuck "Letters: KIM-1, ACT-1; The Scene", Kilobaud p 18 (Apr 1978| 

A generally favorable report of one user's experience in interfacing and 
using ACT-1 with the KIM-1. 

323. Braun, Ludwig, "PET Problems", Personal Computing No. 3, pp 5-6 (March 1978) 

Some observations by a PET owner. 

324. Lasher, Dana "The Exterminator—for Buggy KIMs" 73 Magazine (April, 1978) 

Hardware and Software for a debugging facility. 

325. Eaton, John "Now Anyone Can Afford a Keyboard" 73 Magazine (April, 1978) 

A melding of a surplus keyboard, KIM and software. 

326. Foster, Caxton C. "Programming a Microcomputer: 6502" Addison-Wesley 
Publishing Company, Reading, Mass. 1978 

Caxton C. Foster of the University of Massachusetts, Amherst, has put 
together a very helpful book on programming the 6502 using KIM-1 as a 
lab tool. 

327. Barden, William, Jr. "Computer Corner - 6502" Radio-Electronics (May 1978) 

An in-depth look at the widely used 6502 microprocessor. 

328. Wozniak, Steve "Renumbering and Appending Basic Programs on the Apple-II 
Computer" DDJ Issue 3 (March 1978) 

Comments and techniques for joining two BASIC programs into a single 
larger one. 

329. Eaton, John "A KIM Binary Calculator" DDJ Issue 3 (March 1978) 

An easier way to solve binary math programs. 

330. Wells, Ralph "PET's First Report Card" Kilobaud pp 22-30 (May 1978) 

An objective evaluation of PET serial No. 171. 

331. Blankenship, John "Expand you KIM" Kilobaud, pp 60-63 (May 1978) 

Part 5: A/D interfacing for joysticks. Four channels. 

332. Holland, Hugh C. "KIM Notes" BYTE 3. No. 4, p 163 (April 1978) 

Correction for Hal Chamberlin's Four Part Harmony Program published 
in September 1977 BYTE. 

333. Anon., "Byte's Bits", BYTE 3, No. 4, p 166 (April 1978) 

Notes on picking the right color television for an Apple. 

334. KIM-1 User Notes, Issue 9/10, (January - March 1978) 

Rehnke, Eric "Have you been on the Bus" page 1. 

Kushnier, Ron "Space War Phaser Sound" page 2. 

Butter field, Jim "Skeet Shoot" page 2. 

Edwards, Lew "KIM D-BUG" page 3. 

Flacco, Roy "Graphics Interface" page 4. 

Wood, James "RPN Calculator Interface to KIM" page 6. 

Bennett, Timothy "KUN Index by Subject, Issues 1 to 6" page 12. 

Niessen, Ron "On Verifying Programs in RAM" page 12. 

Pottinger, Hardy "Greeting Card Generator" page 13 . 

173 



6502 BIBLIOGRAPHY 
PART V 

William Dial 

438 Roslyn Avenue 

Akron, OH 44320 

335. Smith, Stephen P. "6502 Disassembler Fix", DDJ 3., No. 23, Issue 3, Pg 3 (March 1978) 

ROR and ROL instructions were omitted in the previously published disassembler - 
DDJ 2.t Issue 1. This offers a simple fix. 

336. KIM-1 User Notes, Issue 9/10, (January - March 1978) 

Butterfield, Jim "Dicey" page 17. A program to roll up to six dice. 

Butterfield, Jim "Teaser" page 17. Jumbo version of Bob Albrecht's "Shooting Stars". 

Lewart, Cass "Correction for Lancaster's TVT" page 20. 

Oliver, John P. "Comments and Corrections for SUPERDUMP/LOAD" pg 21. 

337. Quosig, Karl and Susan "Input/Output", Personal Computing £, No. 4, pg 8 (April 1978). 

Comments on PET problems. 

338. Bishop, Robert J. "Rocket Pilot", Kilobaud No. 13, pg 90 (Jan. 1978) 

And interactive game for the Apple II. 

339. OSI-Small Systems Journal 2, No. 1 (January-February 1978) 

Anon. "What's a USR Function". Via the USR function, one can have a 6502 BASIC program 

which works in conjunction with one or several machine code programs. 
Anon. "Quickie". A 6502 BASIC program for converting decimal to binary numbers. 
Glasser, Daniel "Chessboard". Program in 6502 BASIC for a computer chessboard which 

moves pieces and displays the new board. Not a chess program. 
Anon. "DOS CNTRL" . A BASIC program to perform transfers to or from OSI's new hard 

disk drive. 
Anon. "Track Zero Writer". A Machine language program to modify track zero. 
Anon. "9 Digit BASIC". A concise method for modifying OSI 9 Digit BASIC for an 

end-user 9 Digit BASIC. 
Anon. "OS-65U Performs". A description of a new system said to be a new standard for 

microcomputer operating systems. 
Anon. "500/510 Breakpoint Utilities". A breakpoint program. 
Anon. "510 Tracer". A tracer program which prints a disassemble of the next instruction 

to be executed . 

340. Bishop, Robert J. "Fiendish New QUBIC Program", 73 Magazine, No. 209, Pg 78 (Feb 1978). 

An attempt at producing an improved version of the original Qubic program. 

341. Rosner, Richard "Daddy, Is It The PET?", ROM 1, No. 9, pg 26 (Mar/April 1978) 

Description of many features and operations of the PET, including many "how to" 
instructions. 

342. Bishop, Robert J. "LOGAN - A Logic Circuit Analysis Program", Interface Age 2, No. 6, 

pg 128 (May 1977). An Apple I BASIC program for analyzing networks of logic gates. 

343- Bishop, Robert J. "Apple Star Trek", Interface Age 2, No. 6, pg 132 (May 1977). 
Star Trek written in Apple I BASIC. 

344. Chamberlin, Hal "Microcomputer Input/Output", Popular Electronics .13, No. 5, pg 86 (May 1978). 

Comments on the KIM's memory-mapped I/O system. 

345. Peoples Computers j5_, No. 6 (May/ June 1978) 

Johnson, Ralph "Letters". The University of California at San Diego plans a Pascal 

system for the 6502. 
Cole, Phyllis "Apple II". A review of this 6502 based micro. 
Voros, Todd L. "Sketchcode" . A technique to minimize errors and simplify the process 

of debugging. Listed in 6502 assembly code. 
Of fen, Dave "Kaleidoscope". A continuously running graphics program for the PET. 
Hofheintz, M. C. "Tiny GRAPHICS". A short graphics program for the PET. 

346. Gordon, H. T. "Editha", DDJ 3., Issue 5, No. 25, pg 34 (May 1978). A revision of the 

Fylstra KIM-1 Editor program "SWEETS" published in BYTE. 

347. Tullock, Michael "PET Files", Personal Computing 2, No. 5, pg 20 (May 1978). Things your 

user's manual never told you about PET. How to use files. 
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348. O'Reilly, Francis J. "Instruction Search", Byte 3, No. 5, pg 153 (May 1978). Discussion 

of 6502 op code 27 and the search for other as yet undefined instructions. 

349. Carpenter, Charles R. "Tiny BASIC Shortcuts", Kilobaud, Issue 18, pg 42 (June 1978). 

Suggests methods to expand the capabilities of Tom Pittman's Tiny BASIC for the 6502. 

350. O'Haver, T. C. "More Music for the 6502", Byte 2, No. 6, pg 140 (June 1978). A music 

composition and generation program. 

351. O'Haver, T. C. "Audio Processing with a Microcomputer", Byte 3., No. 6, pg 166 (June 1978). 

Adding a virtual tape loop. Uses a 6502 processor. 

352. Eaton, John "Low Cost Keyboard - II", 73 Magazine, No 213, pg 100 (June 1978). Part II 

of an article on the low-cost keyboard. Software is designed around the 6502. 

353- Swindle, David "A Sensible Expansion: Atwood Memory for your KIM", Kilobaud, Issue 19, 
pg 60 (July 1978). Description of a low cost method to add memory to KIM. 

354. MICRO, Issue 4 (April/May 1978) 

Carpenter, C. R. "Variables Chart". Chart to layout and keep track of string and 

numerical variables for Apple II Applesoft BASIC. 
Floto, Charles "The PET Vet Examines Some BASIC Idiosyncrasies". Includes suggestions 

and modifications for a Mailing List Program by Richard Rosner. 
DeJong, Marvin L. "A Complete Morse Code Send/Receive Program for the KIM-1". Converts 

ASCII from a keyboard to a Morse code digital signal and also converts a Morse code 

digital signal to an ASCII code for display on a video system. 
O'Brien "PET Software from Commodore". New selected Application notes from Commodore. 
Floto, Charles "Early PET-Compatible Products". A review of several new accessories 

for the PET. 
Rowe, Mike "The MICRO Software Catalog". A continuing catalog of software available 

for 6502 based systems. 
Carpenter, C. R. "Apple II Printing Update". Updated information and modifications of 

the system described previously in MICRO No. 3. 
Chamberlin, Hal "Standard 6502 Assembly Syntax?". A plea for standardization. 

Rowe, Mike "A Worm in the Apple". Discussion of some problems encountered in inter- 
facing the Apple to other devices such as the 6820 PIA. 

Jenkins, Gerald C. "A KIM Beeper". A short blast or two of audio for load errors, 
end-of-line , etc . 

Auricchio, Rick "An Apple II Programmer's Guide". Some of the previously undisclosed 
details of the Apple Monitor. 
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O'Connor, Clint "Book Review: Programming a Microcomputer: 6502", Kilobaud, Issue 20 
pg 8 (August 1978). A very favorable review of Caxton C. Foster--* h™v 



356. Grossman, Rick "KIM Plus Chess Equals Microchess" , Kilobaud, Issue 20, pg 74 (August 1978) 

A challenging game of Chess can be played in KIM's. 1K of memroy using MicroChess by 
Peter Jennings. J 

357. Palenik, Les "FINANC - A Home/Small-Business Financial Package", Kilobaud, Issue 20, pg 84 

(August 1978). Programs include Calculations on investments, Depreciation, Loans, etc. 

358. Braun, Ludwig "Commodore PET", Creative Computing!, No. 4, pg 24 (July/ August 1978) 

359. Creative Computing 4, No. 4 (July/ August 1978). 

Braun, Ludwig "Commodore Pet". An equipment profile which stresses the value of the 

PET as a teaching machine. 
North, Steve "Apple II Computer". An equipment profile points out that the Apple is 

not a machine for the classroom or for the S-100 hardware buff but is one of the 

most versatile micros on the market. 
Dawkins, Gary D. "High-Resolution Graphics for the Apple II". Allows user to draw a 

shape in high-resolution graphics mode from the keyboard. 
Ahl, David H. "Atari Video Computer System". An equipment profile of a 6505 based 

programmable game system. 
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360. MICRO, Issue 5 (June/ July 1978) 

Covitz, Frank H. "Life for your PET". LIFE written in machine language for the PET. 
Rockwell International ""Rockwell's New R6500/1". The 6500/1 is a single chip NMOS 

microcomputer, 1 or 2 MHz, fully compatible with the 6500 family. 
De Jong, Marvin L. "6502 Interfacing for Beginners: Address Decoding I". The first 

installment in a continuing series. 
Rowe, Mike "Half a Worm in the Apple". More on the controversy on interfacing the 

Apple to PIA's. See also EDN May 20, 1978. 
Sander-Cederlof, Bob "A Slow List for Apple BASIC". Program slows down the list 

process so it can be more easily reviewed . 
Rowe, Mike "The Micro Software Catalog: II". The second part of this continuing 

series. 

Synertek Inc. "Synertek's VIM-1". A good description of the many features of the 
6502 based VIM-1. Similar to and compatible with KIM-1 with some new features. 

Suitor, Richard F. "Applayer Music Interpreter". A music interpreter written in 
6502 assembly language for the Apple, but can be used on other 6502 systems. 

Dial, William "6502 Bibliography - Part IV". The fourth part of the continuing 
bibliography of the 6502 literature (of which this is the fifth part!). 

Williams, J. C. "A Block Hex Dump and Character Map Utility Prdgram for the KIM-1". 
A fully relocatable utility program which will dump a specified block of memory 
from a KIM to a terminal in several formats. 

Rockwell International "Rockwell's AIM is Pretty Good". Rockwell's AIM 65 is an 
assembled versatile microcomputer system on one board plus keyboard. It has a 
20-character display and a 20-character thermal printer, 4K ROM monitor, 1K RAM 
expandable on board to 4K. Application and Expansion connectors are fully KIM-1 
compatible. TTY and Audio Cassette, DEBUG/MONITOR/ ROM or EPROM on board up to 
16K. 8K BASIC will be available in ROM. 

Carpenter , Chuck "Apple II Accessories and Software" . Items reviewed include a 
renumber and append program, a serial interface board, a MODEM, Applesoft II, 
and the "APPLE II BASIC Programming Manual. 

McCann, Michael J. "A BASIC 6502 Disassembler for Apple and PET". Accepts machine 
language -object code- and produces a symbolic representation that resembles an 
assembly listing. Originally written in Commodore BASIC, it will work with 
Applesoft BASIC as well. 



176 



LDA 


AD LDAIM 


A9 


LDAZ 


A5 


LDAIX 


A1 LDAIY B1 


LDAZX 


B5 LDAX BD 


LDAi 


' B9 


N Z 


STA 


8D 




STAZ 


85 


STAIX 


81 STAIY 91 


STAZX 


95 STAX 9D 


STAY 99 




ADC 


6D ADCIM 


69 


ADCZ 


65 


ADCIX 


61 ADCIY 71 


ADCZX 


75 ADCX 7D 


ADO 


79 


N Z C V 


SBC 


ED SBCIM 


E9 


SBCZ 


E5 


SBCIX 


E1 SBCIY F1 


SBCZX 


F5 SBCX FD 


SBCY 


' F9 


N Z C V 


AND 


2D ANDIM 


29 


ANDZ 


25 


ANDIX 


21 ANDIY 31 


ANDZX 


35 ANDX 3D 


ANDY 


39 


N Z 


EOR 


4D EORIM 


49 


EORZ 


45 


EORIX 


41 EORIY 51 


EORZX 


55 EORX 5D 


EORY 


59 


N Z 


ORA 


OD ORAIM 


09 


ORAZ 


05 


ORAIX 


01 ORAIY 11 


ORAZX 


15 ORAX 1D 


ORAY 


' 19 


N Z 


CMP 


CD CMPIM 


C9 


CMPZ 


C5 


CMPIX 


C1 CMP 


IY D1 


CMPZX 


D5 CMPX DD 


CMPY 


D9 


N Z C 


ASL 


OE ASLA 


OA 


ASLZ 


06 








ASLZX 


16 ASLX 1E 






N Z C 


LSR 


4E LSRA 


4A 


LSRZ 


46 








LSRZX 


56 LSRX 5E 






N Z C 


ROL 


2E ROLA 


2A 


ROLZ 


26 








ROLZX 


36 ROLX 3E 






N Z C 


ROR 


6E -RORA 


6A 


RORZ 


66 








RORZX 


76 RORX 7E 






N Z C 


DEC 


CE 




DECZ 


C6 








DECZX 


D6 DECX DE 






N Z 


INC 


EE 




INCZ 


E6 








INCZX 


F6 INCX FE 






N Z 


BIT 


2C 




BITZ 


24 


















7 Z 6 


LDX 


AE LDXIM 


A2 


LDXZ 


A6 








LDXZY 


B6 




LDXY 


BE 


N Z 


STX 


8E 




STXZ 


86 








STXZY 


96 










CPX 


EC CPXIM 


EO 


CPXZ 


E4 


















N Z C 


DEX 


CA INX 


E8 






















N Z 


LDY 


AC LDYIM 


AO 


LDYZ 


A4 








LDYZX 


B4 LDYX BC 






N Z 


STY 


8C 




STYZ 


84 








STYZX 


94 










CPY 


EC CPYIM 


CO 


CPYZ 


C4 


















N Z C 


DEY 


88 INY 


C8 






















N Z 


BPL 


10 BMI 


30 BVC 50 BVS 


70 BCC 90 BCS BO 


BNE 


DO 


BEQ 


FO 


CLC 


18 SEC 


38 CLI 58 SEI 


78 




CLV B8 


CLD 


D8 


SED 


F8 


JMP 


4C JMPI 6C JSR 20 RTS 


60 RTI 40 BRK 00 


NOP 


EA 






TAX 


AA TXA 


8A TAY A8 TYA 


98 TSX BA TXS 9A 








N Z 


PHA 


48 PLA 


6fc 


PHP 08 PLP 


28 (Flags Restored) 








N Z 




I = Indirect 










A = 


Accumulator 










IM = Immediate 










Z = 


Zero 


page 










X = absolute i 


ndexed by 


X 




Y = 


absolute indexed by 


Y 




IX = Index 


ed indirect by 


X 




IY = 


Indirect indexed by 


Y 




ZX = Zero 


page 


indexed by X 




ZY = 


Zero 


page indexed by Y 




No extension for Relative, Implied or Absolute 


addressing 


modes. 














LEAST 


SIGNIFICANT 


DIGIT 















1 


2 


4 


5 


6 


8 


9 


A 


C 


D 


E 




BRK 


ORAIX 






ORAZ 


ASLZ 


PHP 


ORAIM 


ASLA 




ORA 


ASL 




1 BPL 


ORAIY 






ORAZX 


ASLZX CLC 


ORAY 






ORAX ASLX 




2 JSR 


ANDIX 




BITZ 


ANDZ 


ROLZ 


PLP 


ANDIM 


ROLA 


BIT 


AND 


ROL 




3 BMI 


ANDIY 






ANDZX 


ROLZX SEC 


ANDY 






ANDX ROLX 


M 


4 RTI 


EORIX 






EORZ 


LSRZ 


PHA 


EORIM 


LS.RA 


JMP 


EOR 


LSR 


Q 


5 BVC 


EORIY 






EORZX 


LSRZX CLI 


EORY 






EORX LSRX 


E-i 


6 RTS 


ADCIX 






ADCZ 


RORZ 


PLA 


ADCIM 


RORA 


JMPI 


ADC 


ROR 




7 BVS 


ADCIY 






ADCZX 


RORZX SEI 


ADCY 






ADCX RORX 




8 


STAIX 




STYZ 


STAZ 


STXZ 


DEY 




TXA 


STY 


STA 


STX 


l-l 


9 BCC 


STAIY 




STYZX 


STAZX 


STXZY TYA 


STAY 


TXS 




STAX 


o 

M 


A LDYIM 


LDAIX LDXIM LDYZ 


LDAZ 


LDXZ 


TAY 


LDAIM 


TAX 


LDY 


LDA 


LDX 


w 


B BCS 


LDAIY 




LDYZX 


LDAZX 


LDXZY CLV 


LDAY 


TSX 


LDYX 


LDAX LDXY 


E-h 


C CPYIM 


CMPIX 




CPYZ 


CMPZ 


DECZ 


INY 


CMPIM 


DEX 


CPY 


CMP 


DEC 


O 

s 


D BNE 


CMPIY 






CMPZX 


DECZX CLD 


CMPY 






CMPX DECX 




E CPXIM 


SBCIX 




CPXZ 


SBCZ 


INCZ 


INX 


SBCIM 


NOP 


CPX 


SBC 


INC 




F BEQ 


SBCIY 






SBCZX 


INCZX SED 


SBCY 






SBCX INCX 



M®[a®i 



176A 



ASCII CONVERSION TABLE 



HEX 



BITS 





1 1 

10 

11 

10 

10 1 
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10 
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